more on footnotes

1 files changed, 13 insertions, 4 deletions

diff --git a/ekdosis.dtx b/ekdosis.dtx
index 111a1b9..3196903 100644
--- a/ekdosis.dtx
+++ b/ekdosis.dtx
@@ -4438,9 +4438,10 @@ argument of the
 %
 % \DescribeMacro{\SetFootnotes} \newfeature[v1.5]
 % \cs{SetFootnotes}\marg{csv list of footnote settings} can be used
-% either in the preamble or at any point of the document \emph{as long
-% it is inserted outside the \env{alignment} environment}. This
-% command accepts the following list of |key-value| optional
+% either in the preamble or at any point of the document. However, the
+% options for regular footnotes must be set outside the
+% \env{alignment} environment. This command accepts the following list
+% of |key-value| optional
 % arguments:---\\
 % \DescribeOption{layout} \phts\label{ref:setfootnotes-layout}
 % |layout|$=$\verb+default|column|page|merge+
@@ -4482,7 +4483,15 @@ argument of the
 % inserted in the \env{alignment} environment, the following options
 % apply to both the \env{alignment} and \env{ekdosis} environments.
 %
-% \DescribeMacro{\SetFootnotes} (\emph{Continued from above})\\
+% \DescribeMacro{\SetFootnotes} (\emph{Continued from above}) Unlike
+% the options for regular footnotes, those for footnotes combined into
+% a single paragraph can be set at any point of the
+% document.
+% \danger It is however not recommended to use \cs{SetFoonotes} in
+% environments to be transcribed into \texttt{TEI xml}. The way to
+% restrict the effect of this command to one of the defined
+% environments is to use \cs{AtBeginEnvironment} as described in
+% \vref{sec:alignment-hooks}.\\
 % \DescribeOption{layout}|layout=paragraph|
 % \hfill\tcboxverb{Default: not set}\\
 % |layout=paragraph| comes in addition to the other three values