[latex3-commits] [latex3/latex3] main: Document performanc of tl-build (fixes #1393) (8947e5981)

[github at latex-project.org]

Repository : https://github.com/latex3/latex3
On branch  : main
Link       : https://github.com/latex3/latex3/commit/8947e59811006c0a553bd5b07378596da4544d83

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

commit 8947e59811006c0a553bd5b07378596da4544d83
Author: Joseph Wright <joseph.wright at morningstar2.co.uk>
Date:   Sun Jan 7 19:25:51 2024 +0000

    Document performanc of tl-build (fixes #1393)


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

8947e59811006c0a553bd5b07378596da4544d83
 l3kernel/l3tl-build.dtx | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/l3kernel/l3tl-build.dtx b/l3kernel/l3tl-build.dtx
index 645f052d1..d1f99816e 100644
--- a/l3kernel/l3tl-build.dtx
+++ b/l3kernel/l3tl-build.dtx
@@ -59,6 +59,12 @@
 % constructed token list cannot be accessed during construction other than
 % by methods provided in this section.
 %
+% Whilst the exact performance difference is dependent on the size of each
+% added block of tokens and the total number of blocks, in general, the
+% \cs[no-index]{tl_build_(g)put...} functions will out-perform the basic
+% \cs[no-index]{tl_(g)put...} equivalent if more than 200 non-empty addition
+% operations occur.
+%
 % \begin{function}[added = 2018-04-01]{\tl_build_begin:N, \tl_build_gbegin:N}
 %   \begin{syntax}
 %     \cs{tl_build_begin:N} \meta{tl~var}