[latex3-commits] [latex3/latex3] main: Clarify behavior of `\tl_if_novalue:n(TF)` (see #1402) (7d2dfca62)

[github at latex-project.org]

Repository : https://github.com/latex3/latex3
On branch  : main
Link       : https://github.com/latex3/latex3/commit/7d2dfca624fcaaac1ede2f50106300078706233d

>---------------------------------------------------------------

commit 7d2dfca624fcaaac1ede2f50106300078706233d
Author: Yukai Chou <muzimuzhi at gmail.com>
Date:   Tue Jan 2 15:29:36 2024 +0800

    Clarify behavior of `\tl_if_novalue:n(TF)` (see #1402)


>---------------------------------------------------------------

7d2dfca624fcaaac1ede2f50106300078706233d
 l3kernel/CHANGELOG.md | 1 +
 l3kernel/l3tl.dtx     | 8 ++++++--
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/l3kernel/CHANGELOG.md b/l3kernel/CHANGELOG.md
index 96e6a1243..76f0782c1 100644
--- a/l3kernel/CHANGELOG.md
+++ b/l3kernel/CHANGELOG.md
@@ -14,6 +14,7 @@ this project uses date-based 'snapshot' version identifiers.
 
 ### Changed
 - Improved method to suppress `l3bitset` where required
+- Clarify behavior of `\tl_of_novalue:n(TF)` (see issue \#1402)
 
 ### Deprecated
 - `\tl_build_get:NN` in favor of `\tl_build_get_intermediate:NN`
diff --git a/l3kernel/l3tl.dtx b/l3kernel/l3tl.dtx
index 6c0ad1c13..5fbe31aa2 100644
--- a/l3kernel/l3tl.dtx
+++ b/l3kernel/l3tl.dtx
@@ -330,8 +330,12 @@
 %     \cs{tl_if_novalue_p:n} \Arg{token list}
 %     \cs{tl_if_novalue:nTF} \Arg{token list} \Arg{true code} \Arg{false code}
 %   \end{syntax}
-%   Tests if the \meta{token list} is exactly equal to the special
-%   \cs{c_novalue_tl} marker. This function is intended to allow construction
+%   Tests if the \meta{token list} is exactly equal to the content of special
+%   \cs{c_novalue_tl} marker, hence it is functionally the same as
+%   \begin{quote}
+%     \cs{tl_if_eq:NnTF} \cs{c_novalue_tl} \Arg{token list} \Arg{true code} \Arg{false code}
+%   \end{quote}
+%   but expandable. This function is intended to allow construction
 %   of flexible document interface structures in which missing optional
 %   arguments are detected.
 % \end{function}