diff options
Diffstat (limited to 'macros/latex/contrib/l3kernel/l3text.dtx')
-rw-r--r-- | macros/latex/contrib/l3kernel/l3text.dtx | 41 |
1 files changed, 16 insertions, 25 deletions
diff --git a/macros/latex/contrib/l3kernel/l3text.dtx b/macros/latex/contrib/l3kernel/l3text.dtx index 8df534cc84..ea33b58855 100644 --- a/macros/latex/contrib/l3kernel/l3text.dtx +++ b/macros/latex/contrib/l3kernel/l3text.dtx @@ -43,7 +43,7 @@ % }^^A % } % -% \date{Released 2023-10-10} +% \date{Released 2023-10-23} % % \maketitle % @@ -94,18 +94,18 @@ % % \section{Case changing} % -% \begin{function}[EXP, added = 2019-11-20, updated = 2022-10-13] +% \begin{function}[EXP, added = 2019-11-20, updated = 2023-07-08] % { -% \text_lowercase:n, \text_uppercase:n, \text_titlecase:n, +% \text_lowercase:n, \text_uppercase:n, \text_titlecase_all:n, % \text_titlecase_first:n, -% \text_lowercase:nn, \text_uppercase:nn, \text_titlecase:nn, +% \text_lowercase:nn, \text_uppercase:nn, \text_titlecase_all:nn, % \text_titlecase_first:nn % } % \begin{syntax} % \cs{text_uppercase:n} \Arg{tokens} % \cs{text_uppercase:nn} \Arg{BCP-47} \Arg{tokens} % \end{syntax} -% Takes user input \meta{text} first applies \cs{text_expand}, then +% Takes user input \meta{text} first applies \cs{text_expand:n}, then % transforms the case of character tokens as specified by the % function name. The category code of letters are not changed by this % process when Unicode engines are used; in $8$-bit engines, case changed @@ -115,11 +115,13 @@ % % Upper- and lowercase have the obvious meanings. Titlecasing may be regarded % informally as converting the first character of the \meta{tokens} to -% uppercase and the rest to lowercase. However, the process is more complex +% uppercase. However, the process is more complex % than this as there are some situations where a single lowercase character % maps to a special form, for example \texttt{ij} in Dutch which becomes -% \texttt{IJ}. The \texttt{titlecase_first} variant does not attempt -% any case changing at all after the first letter has been processed. +% \texttt{IJ}. There are two functions available for titlecasing: one which +% applies the change to each \enquote{word} and a second which only applies +% at the start of the input. (Here, \enquote{word} boundaries are spaces: +% at present, full Unicode word breaking is not attempted.) % % Importantly, notice that these functions are intended for working with % user \emph{text for typesetting}. For case changing programmatic data see @@ -163,10 +165,7 @@ % I-dot and introduced when upper casing i-dotless. % \item German (\texttt{de-x-eszett}). % An alternative mapping for German in which the lowercase -% \emph{Eszett} maps to a \emph{gro\ss{}es Eszett}. Since there is -% a |T1| slot for the \emph{gro\ss{}es Eszett} in |T1|, this -% tailoring \emph{is} available with \pdfTeX{} as well as in the -% Unicode \TeX{} engines. +% \emph{Eszett} maps to a \emph{gro\ss{}es Eszett}. % \item Greek (\texttt{el}). % Removes accents from Greek letters when uppercasing; titlecasing % leaves accents in place. A variant \texttt{el-x-iota} is available @@ -185,25 +184,17 @@ % The characters |u| and |V| are interchanged on case changing. % \item Dutch (\texttt{nl}). % Capitalisation of \texttt{ij} at the beginning of titlecased -% input produces \texttt{IJ} rather than \texttt{Ij}. The output -% retains two separate letters, thus this transformation \emph{is} -% available using \pdfTeX{}. +% input produces \texttt{IJ} rather than \texttt{Ij}. % \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 +% Determining whether non-letter characters at the start of text should count +% as the uppercase element 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. +% \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. +% character is uppercased, irrespective of the category code of the character. % % \begin{function}[added = 2022-07-04] % { |