[latex3-commits] [l3svn] branch master updated: l3str: a note about when to use strings

[noreply at latex-project.org]

This is an automated email from the git hooks/post-receive script.

will pushed a commit to branch master
in repository l3svn.

The following commit(s) were added to refs/heads/master by this push:
       new  cfa6183   l3str: a note about when to use strings
cfa6183 is described below

commit cfa61839c311d5a94edb7ad14ab542086376d610
Author: Will Robertson <will at wspr.io>
Date:   Wed Jun 28 21:34:56 2017 +0930

    l3str: a note about when to use strings
    
    I feel like this isn't written particularly well, but having it here is better than not :)
---
 l3kernel/l3str.dtx |    7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/l3kernel/l3str.dtx b/l3kernel/l3str.dtx
index ec90abd..19eb9f5 100644
--- a/l3kernel/l3str.dtx
+++ b/l3kernel/l3str.dtx
@@ -69,6 +69,13 @@
 % and do not treat a token list or the corresponding string
 % representation differently.
 %
+% As a string is a subset of the more general token list, it is sometimes unclear
+% when one should be used over the other.
+% Use a string variable for data that isn’t primarily intended for typesetting
+% and for which a level of protection from unwanted expansion is suitable.
+% This data type simplifies comparison of variables since there are no concerns
+% about expansion of their contents.
+%
 % Note that as string variables are a special case of token list variables
 % the coverage of \cs[no-index]{str_\ldots{}:N} functions is somewhat smaller than
 % \cs[no-index]{tl_\ldots{}:N}.

-- 
To stop receiving notification emails like this one, please contact
the administrator of this repository.