1 files changed, 29 insertions, 20 deletions

diff --git a/ekdosis.dtx b/ekdosis.dtx
index 3e6ba5f..a429ee2 100644
--- a/ekdosis.dtx
+++ b/ekdosis.dtx
@@ -61,7 +61,7 @@ along with this program.  If not, see
 %<package>\NeedsTeXFormat{LaTeX2e}[1999/12/01]
 %<package>\ProvidesPackage{ekdosis}
 %<*package>
-    [2021/08/17 v1.3 Typesetting TEI xml-compliant critical editions]
+    [2021/08/18 v1.3 Typesetting TEI xml-compliant critical editions]
 %</package>
 %<*driver>
 \begin{filecontents}[noheader,overwrite]{bibdata.xml}
@@ -4804,8 +4804,9 @@ substantiall fewell,}
 % \pkg{babel},\footcite[See][3.2 \pno~14]{polyglossia} the general
 % advice given above in \vref{sec:alignment-hooks} applies in all
 % cases. As regards setting languages in the \texttt{TEI xml} output
-% file, the reader is invited to refer to point \vref{it:lang-subopt}
-% and \vref{sec:teixml-output}.
+% file, the reader is invited to refer to point \vref{it:lang-subopt},
+% and \vref{sec:teixml-output} including the example provided
+% \vpageref{ref:ancientgreek-ex}.
 %
 % \danger In some cases, it may be needed to apply in the apparatus
 % criticus a language different from the one that is selected in the
@@ -5284,7 +5285,7 @@ subtype="arabtex">'inna 'abI kAna mina
 % being |1| and the smallest being |9|.\\
 % \DescribeOption{toc}
 % |toc|$=$\verb+book|part|chapter|section|subsection|subsubsection|paragraph|+\\
-% |subparagraph|\hfill\tcboxverb{Default: not set}\\
+% \phantom{|toc|$=$}|subparagraph|\hfill\tcboxverb{Default: not set}\\
 % If |toc| be set, the title of the division goes into the table of
 % contents at the hierarchic level that is specified as value.\\
 % \DescribeOption{mark} \newfeature[v1.3] |mark|$=$\meta{signpost}
@@ -6208,7 +6209,8 @@ many mathematical writings and to the sense of
 % example illustrates how \cs{EnvtoTEI} can be used conjointly with
 % \pkg{babel} to convey information about the languages used from
 % \LaTeX\ to \texttt{TEI}:---
-% 
+%
+% \phts\label{ref:ancientgreek-ex}
 % \iffalse
 %<*example>
 % \fi
@@ -7651,7 +7653,7 @@ Sample text with a \textcolor{red}{word} in red.
 %    \end{macrocode}
 % \paragraph{Setup}
 % \begin{macro}{\ekdsetup}
-% \changes{v1.3}{2021/08/17}{new command for global options}
+% \changes{v1.3}{2021/08/18}{new command for global options}
 % \cs{ekdsetup} is used to specify options that affect the general
 % behavior of \pkg{ekdosis}. It is a preamble-only command.
 %    \begin{macrocode}
@@ -7674,7 +7676,7 @@ Sample text with a \textcolor{red}{word} in red.
 %   \texttt{lemmastyle}}
 %   \changes{v1.2}{2021/04/02}{general hooks: new option
 %   \texttt{readingstyle}}
-%   \changes{v1.3}{2021/08/17}{general hooks: new options
+%   \changes{v1.3}{2021/08/18}{general hooks: new options
 %   \texttt{keyparopts} and \texttt{appheight}}
 %    \begin{macrocode}
 \ekvdefinekeys{ekd@hooks}{
@@ -7895,7 +7897,7 @@ Sample text with a \textcolor{red}{word} in red.
 %    \end{macrocode}
 % \end{macro}
 % \begin{macro}{\teidirect}
-% \changes{v1.3}{2021/08/17}{direct insertion of elements in the
+% \changes{v1.3}{2021/08/18}{direct insertion of elements in the
 % \texttt{TEI xml} file}
 % \cs{teidirect}\oarg{xml attributes}\marg{xml element}\marg{code}
 % does nothing in \LaTeX. Its only use is to insert elements in the
@@ -8188,11 +8190,11 @@ Sample text with a \textcolor{red}{word} in red.
   initial rule = \rule{0.4\columnwidth}{0.4pt},
   noval norule = \def\ekd@default@rule{\mbox{}},
   store lang = \ekd@singleapp@lang,
-  initial lang = \ltx@ifpackageloaded{babel}{\languagename}{}%
-                 \ltx@ifpackageloaded{polyglossia}{\languagename}{},
+  initial lang = \ltx@ifpackageloaded{babel}{\languagename}{%
+    \ltx@ifpackageloaded{polyglossia}{\languagename}{}},
   store notelang = \ekd@singleapp@note@lang,
-  initial notelang = \ltx@ifpackageloaded{babel}{\languagename}{}%
-                 \ltx@ifpackageloaded{polyglossia}{\languagename}{}
+  initial notelang = \ltx@ifpackageloaded{babel}{\languagename}{%
+  \ltx@ifpackageloaded{polyglossia}{\languagename}{}}
 }
 %    \end{macrocode}
 % \begin{macro}{\SetApparatus}
@@ -8262,7 +8264,7 @@ Sample text with a \textcolor{red}{word} in red.
 %    \end{macrocode}
 % \end{macro}
 % \begin{macro}{\SetApparatusNoteLanguage}
-% \changes{v1.3}{2021/08/17}{defines an alternate language to be
+% \changes{v1.3}{2021/08/18}{defines an alternate language to be
 % applied in note apparatus entries}
 % \cs{SetApparatusNoteLang}\marg{languagename} can be used when
 % it is needed to apply in entries introduced by the \cs{note} command
@@ -8346,8 +8348,11 @@ Sample text with a \textcolor{red}{word} in red.
 % apparatus criticus, a conditional is first defined.
 %    \begin{macrocode}
 \newif\ifekd@inside@app
+%    \end{macrocode}
+% Then \cs{ekd@fitapp} is defined for |layout=fitapp|:---
+%    \begin{macrocode}
 \if@pkg@fitfloat
-  \newtcboxfit{\ekdfitapp}{%
+  \newtcboxfit{\ekd@fitapp}{%
     blankest,
     fit basedim = \f@size pt,
     fit fontsize macros,
@@ -8355,6 +8360,10 @@ Sample text with a \textcolor{red}{word} in red.
     fit algorithm = \ekd@fit@algorithm,
     float=!b}
 \fi
+%    \end{macrocode}
+% Finally two commands are used to actually insert the apparatus
+% depending on the value set in the |layout| global option.
+%    \begin{macrocode}
 \long\def\ekd@insert@apparatus{%
   \unless\ifekd@mapps
   \ifrtl@app\pardir TRT\leavevmode\textdir TRT\else
@@ -8410,7 +8419,7 @@ Sample text with a \textcolor{red}{word} in red.
     \ekd@insert@keyparapp
   \fi
   \if@pkg@fitfloat
-    \ekdfitapp{\ekd@insert@apparatus}%
+    \ekd@fitapp{\ekd@insert@apparatus}%
   \fi
 }
 %    \end{macrocode}
@@ -9524,7 +9533,7 @@ Sample text with a \textcolor{red}{word} in red.
 %    \end{macrocode}
 % \end{macro}
 % \begin{macro}{\endmark}
-% \changes{v1.3}{2021/08/17}{prints the last-emitted mark of the
+% \changes{v1.3}{2021/08/18}{prints the last-emitted mark of the
 % preceding page}
 % By default, \cs{ekdmark} described below prints the first mark
 % that is emitted on a given page and ignores the mark corresponding
@@ -9546,7 +9555,7 @@ Sample text with a \textcolor{red}{word} in red.
 %    \end{macrocode}
 % \end{macro}
 % \begin{macro}{\edkmark}
-% \changes{v1.3}{2021/08/17}{prints marks in headers or footers}
+% \changes{v1.3}{2021/08/18}{prints marks in headers or footers}
 % \cs{ekdmark} is an argument-less command called in commands used to
 % make headers and footers where the marks stored by means of the
 % |mark| optional argument of \cs{ekddiv} are to be printed.
@@ -9557,7 +9566,7 @@ Sample text with a \textcolor{red}{word} in red.
 %    \end{macrocode}
 % \end{macro}
 % \begin{macro}{\ekdprintmark}
-% \changes{v1.3}{2021/08/17}{prints or removes the marks in headers
+% \changes{v1.3}{2021/08/18}{prints or removes the marks in headers
 % and footers} \cs{ekdprintmark}\marg{selector}\marg{signpost} The
 % signposts printed in headers and footers must be 
 % passed as second argument of \cs{ekdprintmark} so that \pkg{ekdosis}
@@ -9595,7 +9604,7 @@ Sample text with a \textcolor{red}{word} in red.
 %    \end{macrocode}
 % \end{macro}
 % \begin{macro}{\ekdnofhmarks}
-% \changes{v1.3}{2021/08/17}{removes headers and footers on specific
+% \changes{v1.3}{2021/08/18}{removes headers and footers on specific
 % pages} Once the signposts are marked with \cs{ekdprintmark},
 % \cs{ekdnohfmarks} has the same effect as the \LaTeX\ standard
 % command \cs{thispagestyle}|{empty}|.
@@ -9606,7 +9615,7 @@ Sample text with a \textcolor{red}{word} in red.
 %    \end{macrocode}
 % \end{macro}
 % \begin{macro}{\ekdresethfmarks}
-% \changes{v1.3}{2021/08/17}{marks headers and footers as printable}
+% \changes{v1.3}{2021/08/18}{marks headers and footers as printable}
 % \cs{ekdresethfmarks} can be used in rare cases when it is needed to
 % reset headers and footers to their original, viz.\ printable state.
 %    \begin{macrocode}