From e31b220c342d624f2c80e19eeb62db3dd798c19d Mon Sep 17 00:00:00 2001
From: Yukai Chou <muzimuzhi@gmail.com>
Date: Fri, 19 May 2023 20:29:24 +0800
Subject: [PATCH] Clarify `\TEST` and `\TESTEXP` docs

---
 l3build.dtx | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/l3build.dtx b/l3build.dtx
index 9ab8a7ad..17411248 100644
--- a/l3build.dtx
+++ b/l3build.dtx
@@ -951,9 +951,13 @@
 % \item
 % \cs{ERROR} is \emph{not} defined but is commonly used to indicate a code path that should never be reached.
 % \item
-% The \cs{TEST}\marg{title}\marg{contents} command surrounds its \meta{contents} with some \cs{SEPARATOR}s and a \meta{title}.
+% The \cs{TEST}\marg{title}\marg{contents} command runs its \meta{contents}
+% in a group and surrounds the generated log lines with some \cs{SEPARATOR}s
+% and a \meta{title}.
 % \item
-% \cs{TESTEXP} surrounds its contents with \cs{TYPE} and formatting to match \cs{TEST}; this can be used as a shorthand to test expandable commands.
+% \cs{TESTEXP}\marg{title}\marg{contents} surrounds its \meta{contents} with
+% \cs{TYPE} and formatting to match \cs{TEST}; this can be used as a shorthand
+% to test expandable commands.
 % \item
 % \cs{BEGINTEST}\marg{title} \dots \cs{ENDTEST} is an environment form of
 % \cs{TEST}, allowing verbatim material, \emph{etc.} to appear.