summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/l3kernel/l3text.dtx
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2020-03-07 03:00:57 +0000
committerNorbert Preining <norbert@preining.info>2020-03-07 03:00:57 +0000
commit8012fbf3193a5d1699496b198c3bd448973557bd (patch)
treeae7b8f657130de7157724405a57edb37485e9e6c /macros/latex/contrib/l3kernel/l3text.dtx
parent6749f197f068ccc7a12ea95ee2bbfca4942c1b13 (diff)
CTAN sync 202003070300
Diffstat (limited to 'macros/latex/contrib/l3kernel/l3text.dtx')
-rw-r--r--macros/latex/contrib/l3kernel/l3text.dtx32
1 files changed, 31 insertions, 1 deletions
diff --git a/macros/latex/contrib/l3kernel/l3text.dtx b/macros/latex/contrib/l3kernel/l3text.dtx
index 01af5e5c49..8d06641d95 100644
--- a/macros/latex/contrib/l3kernel/l3text.dtx
+++ b/macros/latex/contrib/l3kernel/l3text.dtx
@@ -43,7 +43,7 @@
% }^^A
% }
%
-% \date{Released 2020-03-03}
+% \date{Released 2020-03-06}
%
% \maketitle
%
@@ -180,6 +180,36 @@
% \end{itemize}
% \end{function}
%
+% \subsection{Removing formatting from text}
+%
+% \begin{function}[rEXP, added = 2020-03-05]{\text_purify:n}
+% \begin{syntax}
+% \cs{text_purify:n} \Arg{text}
+% \end{syntax}
+% Takes user input \meta{text} and expands as described for
+% \cs{text_expand:n}, then removes all functions from the resulting
+% text. Math mode material (as delimited by pairs given in
+% \cs{l_text_math_delims_tl} or as the argument to commands listed in
+% \cs{l_text_math_arg_tl}) is left contained in a pair of |$| delimiters.
+% Non-expandable functions present in the \meta{text} must either have a
+% defined equivalent (see \cs{text_declare_purify_equivalent:Nn}) or will
+% be removed from the result. Implicit tokens are converted to their
+% explicit equivalent.
+% \end{function}
+%
+% \begin{function}[added = 2020-03-05]
+% {
+% \text_declare_purify_equivalent:Nn ,
+% \text_declare_purify_equivalent:Nx
+% }
+% \begin{syntax}
+% \cs{text_declare_purify_equivalent:Nn} \meta{cmd} \Arg{replacement}
+% \end{syntax}
+% Declares that the \meta{replacement} tokens should be used whenever the
+% \meta{cmd} (a single token) is encountered. The \meta{replacement} tokens
+% should be expandable.
+% \end{function}
+%
% \subsection{Control variables}
%
% \begin{variable}{\l_text_accents_tl}