From e24fd7fcf465ef7b3042f2c7c4abd9420d1c9d74 Mon Sep 17 00:00:00 2001
From: Robert Alessi <alessi@robertalessi.net>
Date: Fri, 28 May 2021 21:08:18 +0200
Subject: a point about what xml:ids must consist of

---
 ekdosis.dtx | 32 +++++++++++++++++---------------
 1 file changed, 17 insertions(+), 15 deletions(-)

diff --git a/ekdosis.dtx b/ekdosis.dtx
index c0ab205..85b7af7 100644
--- a/ekdosis.dtx
+++ b/ekdosis.dtx
@@ -1252,7 +1252,8 @@ along with this program.  If not, see
 % \begin{enumerate}
 % \item The unique identifier of the witness to be used both in the
 %   |.tex| source file and as an |xml:id| in the \texttt{TEI xml}
-%   output if any.
+%   output if any.\footnote{See \vpageref{ref:xmlid} for more
+%   information.}
 % \item The rendition to be used in the printed apparatus criticus,
 %   which also will be found within the |<sourceDesc>| element of the
 %   \texttt{TEI} header where the description of the witness occurs,
@@ -1318,7 +1319,7 @@ along with this program.  If not, see
 % \begin{enumerate}
 % \item The unique identifier of the hand to be used both in the
 % |.tex| source file and as an |xml:id| in the \texttt{TEI xml} output
-% if any.
+% if any.\footnote{See \vpageref{ref:xmlid} for more information.}
 % \item The unique identifier of the witness the hand is related
 % to. Of course, this witness must have been declared beforehand.
 % \item The rendition to be used in the printed apparatus criticus,
@@ -1452,7 +1453,7 @@ along with this program.  If not, see
 % \begin{enumerate}
 % \item The unique identifier of the scholar to be used both in the
 % |.tex| source file and as an |xml:id| in the \texttt{TEI xml} output
-% if any.
+% if any.\footnote{See \vpageref{ref:xmlid} for more information.}
 % \item The rendition to be used in the apparatus criticus in print,
 % which also will be found within the |<sourceDesc>| element of the
 % \texttt{TEI} header where the description of the persons cited
@@ -5606,18 +5607,19 @@ subtype="arabtex">'inna 'abI kAna mina
 % |false| by means of \cs{SetTEIxmlExport} described above.
 %
 % \paragraph{The \texttt{xml:id} Attribute}
-% As a general rule, the |xml:id| global attribute must be unique for
-% the element that bears the attribute. Furthermore, it must begin
-% with a letter or an underscore and contain no characters other that
-% letters, digits, hyphens, underscores and full stops. \pkg{ekdosis}
-% issues a warning when it finds that any \meta{unique id} of
-% \meta{unique label} expected in the first argument of
-% \cs{DeclareWitness}, \cs{DeclareHand}, \cs{DeclareSource} or
-% \cs{DeclareScholar} is not unique or breaks the rules just
-% described, but does not prevent the |.tex| source file from
-% compiling. Instead, it prints the string |<??>| in place of the
-% expected formatted siglum so that the error in the |.tex| source
-% file can be easily spotted and corrected.
+% \phts\label{ref:xmlid} As a general rule, the |xml:id| global
+% attribute must be unique for the element that bears the
+% attribute. Furthermore, it must begin with a letter or an underscore
+% and contain no characters other than letters of the Latin alphabet
+% either upper or lower case from |a| to |z|, digits, hyphens,
+% underscores and full stops. \pkg{ekdosis} issues a warning when it
+% finds that any \meta{unique id} of \meta{unique label} expected in
+% the first argument of \cs{DeclareWitness}, \cs{DeclareHand},
+% \cs{DeclareSource} or \cs{DeclareScholar} is not unique or breaks
+% the rules just described, but does not prevent the |.tex| source
+% file from compiling. Instead, it prints the string |<??>| in place
+% of the expected formatted siglum so that the error in the |.tex|
+% source file can be easily spotted and corrected.
 %
 % \danger As the \meta{unique id} declared with \cs{DeclareShorthand}
 % is not to be exported in the \texttt{TEI xml} output file,
-- 
cgit v1.2.3