1 files changed, 16 insertions, 14 deletions
diff --git a/Master/texmf-dist/doc/latex/glossary/sampleSec.tex b/Master/texmf-dist/doc/latex/glossary/sampleSec.tex
index 4fdd0de8a82..dc1b3a07770 100644
--- a/Master/texmf-dist/doc/latex/glossary/sampleSec.tex
+++ b/Master/texmf-dist/doc/latex/glossary/sampleSec.tex
@@ -33,10 +33,16 @@
 
 \makeglossary
 
-
-\storeglosentry{glos:I}{name=identity matrix,description=diagonal
+\storeglosentry{ident}{name=identity matrix,description=diagonal
 matrix with 1s along the leading diagonal}
 
+\storeglosentry{diag}{name=diagonal matrix,
+description=matrix whose only non-zero entries are along
+the leading diagonal}
+
+\storeglosentry{sing}{name=singular matrix,
+description=matrix with zero determinant}
+
 \begin{document}
 
 \pagenumbering{roman}
@@ -51,27 +57,23 @@ This is a sample document illustrating the use of the
 
 \chapter{Diagonal matrices}
 
-A diagonal matrix\glossary{name=diagonal matrix,
-description=matrix whose only non-zero entries are along the leading diagonal,format=hyperit}
-is a matrix where all elements not on the leading diagonal are zero.  This is the
+A \gls[format=hyperit]{diag} is a matrix where all elements not on the
+leading diagonal are zero.  This is the
 primary definition, so an italic font is used for the page number.
 
 \newpage
 \section{Identity matrix}
-The identity matrix\glossary{name=identity matrix,
-description=diagonal matrix with 1s along the leading diagonal}
-\ldots
+The \gls[format=hyperit]{ident} is a \gls{diag} whose leading
+diagonal elements are all equal to 1.
 
-Here is another entry for a diagonal matrix\glossary{name=diagonal matrix,
-description=matrix whose only non-zero entries are along the leading diagonal}
+Here is another entry for a \gls{diag}.
 
 \chapter{Singular Matrices}
 
-A singular matrix\glossary{name=singular matrix,
-description=matrix with zero determinant}
-\ldots
+A \gls{sing} is a matrix with zero determinant.
+\useGlosentry{sing}{Singular matrices} are non-invertible.
 
-Another \useGlosentry{glos:I}{identity matrix} entry.
+Another \gls{ident} entry.
 
 \end{document}
 \endinput