From f6c9f2a63576a84a698ded40a01bd7df60db5022 Mon Sep 17 00:00:00 2001
From: Robert Alessi <alessi@robertalessi.net>
Date: Sat, 29 Aug 2020 09:34:38 +0200
Subject: a few corrections in the documentation

---
 ekdosis.dtx | 68 +++++++++++++++++++++++++++++++++++++++++--------------------
 1 file changed, 46 insertions(+), 22 deletions(-)

diff --git a/ekdosis.dtx b/ekdosis.dtx
index 4319887..20ba5ec 100644
--- a/ekdosis.dtx
+++ b/ekdosis.dtx
@@ -829,9 +829,10 @@ along with this program.  If not, see
 %</example>
 % \fi
 %
-% \needspace{5\baselineskip}
 % PDF output:---
 % \medskip
+% 
+% \needspace{7\baselineskip}
 % \begin{alignment}[flush,tcols=1,texts=specimen,apparatus=specimen]
 %   \begin{specimen}
 %   I 
@@ -1805,14 +1806,14 @@ yesterday.
 %   |prewit=|\texttt{coni.} or |prewit=|\texttt{falso coni.}, to print
 %   explanatory words in the apparatus criticus before the abridged
 %   name of the scholar.
-% \item Conversely, line~9 introduces an \emph{emendation} for which
-%   the shorthand |egoscr| has been used to print the exact term
-%   \emph{scripsi} in the apparatus criticus while keeping |ego| as an
-%   |xml:id| for the \texttt{TEI xml} ouput file. Other strategies
-%   could have been used. For example, one could have defined a
-%   specific shorthand to print nothing in place of |ego| and leave
-%   the insertion of technical terms to the |post| optional argument
-%   of \cs{lem}, like so:---
+% \item \label{it:egomute}Conversely, line~9 introduces an
+%   \emph{emendation} for which the shorthand |egoscr| has been used
+%   to print the exact term \emph{scripsi} in the apparatus criticus
+%   while keeping |ego| as an |xml:id| for the \texttt{TEI xml} ouput
+%   file. Other strategies could have been used. For example, one
+%   could have defined a specific shorthand to print nothing in place
+%   of |ego| and leave the insertion of technical terms to the |post|
+%   optional argument of \cs{lem}, like so:---
 % \iffalse
 %<*example>
 % \fi
@@ -1992,7 +1993,8 @@ yesterday.
 % |type=emendation| to indicate that the lacuna has been accepted by
 % the editor.
 %
-% Examples follow:---
+% Examples follow:\footnote{On the use of \texttt{egomute} (l.~2), see
+% above \vref{it:egomute}.}---
 %
 % \iffalse
 %<*example>
@@ -2030,9 +2032,10 @@ yesterday.
 % \iffalse
 %</example>
 % \fi
-%
+% 
 % PDF output:---
 % \medskip
+% 
 % \needspace{7\baselineskip}
 % \resetlinenumber
 % \begin{alignment}[flush,tcols=1,texts=specimen,apparatus=specimen]
@@ -2223,6 +2226,7 @@ yesterday.
 %</example>
 % \fi
 %
+% \needspace{7\baselineskip}
 % \resetlinenumber
 % \FormatDiv{2}{}{.}
 % \begin{alignment}[flush,lcols=2,
@@ -2953,9 +2957,10 @@ Some \app[type=rec2]{
 %</example>
 % \fi
 %
-% \needspace{5\baselineskip}
 % PDF output:---
 % \medskip
+% 
+% \needspace{7\baselineskip}
 % \resetlinenumber
 % \begin{alignment}[flush,tcols=1,texts=specimen,apparatus=specimen]
 %   \begin{specimen}
@@ -3023,9 +3028,10 @@ text to demonstrate how to insert a note in the argument of the
 %</example>
 % \fi
 %
-% \needspace{5\baselineskip}
 % PDF output:---
 % \medskip
+% 
+% \needspace{7\baselineskip}
 % \resetlinenumber
 % \begin{alignment}[flush,tcols=1,texts=specimen,apparatus=specimen]
 %   \begin{specimen}
@@ -3345,9 +3351,10 @@ argument of the
 % \vref{sec:multilayer-apparatus} (multiple-layer apparatus
 % criticus).}
 %
-% \needspace{5\baselineskip}
 % The PDF output with left-to-right apparatus criticus follows:---
 % \medskip
+% 
+% \needspace{7\baselineskip}
 % \resetlinenumber
 % \begin{alignment}[flush,tcols=1,texts=specimen,apparatus=specimen]
 %   \begin{specimen}
@@ -3363,7 +3370,10 @@ argument of the
 % \needspace{5\baselineskip}
 % And here follows the PDF output with right-to-left apparatus
 % criticus:---
-% \medskip \resetlinenumber
+% \medskip
+% 
+% \needspace{7\baselineskip}
+% \resetlinenumber
 % \begin{alignment}[flush,tcols=1,texts=specimen,apparatus=specimen]
 %   \begin{specimen}
 %     \begin{arab}[fullvoc]
@@ -3425,9 +3435,11 @@ argument of the
 %</example>
 % \fi
 %
-% \needspace{7\baselineskip}
 % The PDF output with left-to-right apparatus criticus is of course
 % the same as above:---
+% \medskip
+% 
+% \needspace{7\baselineskip}
 % \resetlinenumber
 % \begin{alignment}[flush,tcols=1,texts=specimen,apparatus=specimen]
 %   \begin{specimen}
@@ -3552,12 +3564,13 @@ subtype="arabtex">'inna 'abI kAna mina
 % Variant readings can be inserted in headings. In this case, the
 % optional argument of the \LaTeX\ sectional command must naturally be
 % used to prevent variants from going into headers, footers or the
-% table of contents, like so:---
+% table of contents, like so:\footnote{On the use of \texttt{egomute}
+% (l.~13), see above \vref{it:egomute}.}---
 % 
 % \iffalse
 %<*example>
 % \fi
-\begin{minted}[linenos=false]{latex}
+\begin{minted}{latex}
 % Preamble:
 \usepackage[teiexport=tidy, divs=latex]{ekdosis}
 \MkBodyDivs{chapter}{section}{}{}{}{}
@@ -3568,7 +3581,11 @@ subtype="arabtex">'inna 'abI kAna mina
     \lem[wit={I,R,H}]{βιβλίον δεύτερον}
     \rdg[wit=V]{λόγος β’}}}
 
-\section{<Τμῆμα πρῶτον>}
+\section[Τμῆμα πρῶτον]{
+  \app{
+    \lem[resp=egomute, type=emendation, nosep,
+     post=suppleui]{\supplied{Τμῆμα πρῶτον}}
+   }}
 Ἄνθρακες θερινοὶ ἐν Κραννῶνι· [...]
 \end{minted}
 % \iffalse
@@ -3588,7 +3605,12 @@ subtype="arabtex">'inna 'abI kAna mina
     <rdg wit="#V">λόγος β’</rdg>
   </app></head>
   <div2 type="section">
-    <head>&lt;Τμῆμα πρῶτον&gt;</head>
+    <head>
+      <app>
+        <lem><supplied resp="#ego" type="emendation">Τμῆμα
+         πρῶτον</supplied></lem>
+      </app>
+    </head>
     <p>Ἄνθρακες θερινοὶ ἐν Κραννῶνι· [...]</p>
   </div2>
 </div1>
@@ -3711,10 +3733,10 @@ subtype="arabtex">'inna 'abI kAna mina
 %</example>
 % \fi
 %
-% \needspace{5\baselineskip}
 % PDF output:---
 % \medskip
 % 
+% \needspace{7\baselineskip}
 % \resetlinenumber
 % \FormatDiv{1}{\begin{center}\Large}{\end{center}}
 % \FormatDiv{2}{\begin{center}\large}{\end{center}}
@@ -4413,6 +4435,7 @@ Sample text with a \textcolor{red}{word} in red.
 % PDF output:---
 % \medskip
 %
+% \needspace{7\baselineskip}
 % \SetTEIxmlExport{autopar=false}
 % \begingroup
 % \newenvironment{speech}{\par\selectlanguage{greek}}{\par}
@@ -4598,10 +4621,10 @@ Sample text with a \textcolor{red}{word} in red.
 %</example>
 % \fi
 %
-% \needspace{7\baselineskip}
 % PDF output:---
 % \medskip
 %
+% \needspace{7\baselineskip}
 % \begin{alignment}[flush,tcols=1,texts=specimen,apparatus=specimen]
 % \resetlinenumber[30]\rightlinenumbers
 % \setlength{\linenumbersep}{-1.5in}
@@ -4769,6 +4792,7 @@ Sample text with a \textcolor{red}{word} in red.
 % PDF output:---
 % \medskip
 %
+% \needspace{7\baselineskip}
 % \resetlinenumber
 % \begin{alignment}[flush,tcols=1,texts=specimen,apparatus=specimen]
 %   \begin{specimen}
-- 
cgit v1.2.3