summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/l3kernel/l3text.dtx
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/l3kernel/l3text.dtx')
-rw-r--r--macros/latex/contrib/l3kernel/l3text.dtx27
1 files changed, 26 insertions, 1 deletions
diff --git a/macros/latex/contrib/l3kernel/l3text.dtx b/macros/latex/contrib/l3kernel/l3text.dtx
index 8d06641d95..b8d536b18a 100644
--- a/macros/latex/contrib/l3kernel/l3text.dtx
+++ b/macros/latex/contrib/l3kernel/l3text.dtx
@@ -43,7 +43,7 @@
% }^^A
% }
%
-% \date{Released 2020-03-06}
+% \date{Released 2020-04-06}
%
% \maketitle
%
@@ -178,6 +178,21 @@
% retains two separate letters, thus this transformation \emph{is}
% available using \pdfTeX{}.
% \end{itemize}
+%
+% For titlecasing, note that there are two functions available. The
+% function \cs{text_titlecase:n} applies (broadly) uppercasing to the first
+% letter of the input, then lowercasing to the remainder. In contrast,
+% \cs{text_titlecase_first:n} \emph{only} carries out the uppercasing operation,
+% and leaves the balance of the input unchanged. Determining whether
+% non-letter characters at the start of text should switch from upper- to
+% lowercasing is controllable. When \cs{l_text_titlecase_check_letter_bool} is
+% \texttt{true}, characters which are not letters (category code~$11$) are
+% left unchanged and \enquote{skipped}: the first \emph{letter} is uppercased.
+% (With $8$-bit engines, this is extended to active characters which form
+% part of a multi-byte letter codepoint.) When
+% \cs{l_text_titlecase_check_letter_bool} is \texttt{false}, the first
+% character is uppercased, and the rest lowercased, irrespective of the nature
+% of the character.
% \end{function}
%
% \subsection{Removing formatting from text}
@@ -234,10 +249,20 @@
% content \emph{may} be excluded from processing.
% \end{variable}
%
+% \begin{variable}{\l_text_case_exclude_arg_tl}
+% Lists commands which are excluded from case changing.
+% \end{variable}
+%
% \begin{variable}{\l_text_expand_exclude_tl}
% Lists commands which are excluded from expansion.
% \end{variable}
%
+% \begin{variable}{\l_text_titlecase_check_letter_bool}
+% Controls how the start of titlecasing is handled: when \texttt{true}, the
+% first \emph{letter} in text is considered. The standard setting is
+% \texttt{true}.
+% \end{variable}
+%
% \end{documentation}
%
% \begin{implementation}