[latex3-commits] [latex3/l3sys-query] 2e: Simplify quote handling (f9c0158)

[github at latex-project.org]

Repository : https://github.com/latex3/l3sys-query
On branch  : 2e
Link       : https://github.com/latex3/l3sys-query/commit/f9c0158ac6457bee971b3ab2d025c6f4e65dc9dd

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

commit f9c0158ac6457bee971b3ab2d025c6f4e65dc9dd
Author: Joseph Wright <joseph at texdev.net>
Date:   Sat Mar 9 08:52:50 2024 +0000

    Simplify quote handling
    
    Anticipating Akira's change.


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

f9c0158ac6457bee971b3ab2d025c6f4e65dc9dd
 l3sys-query.lua |  3 +--
 l3sys-query.tex | 31 +++++--------------------------
 2 files changed, 6 insertions(+), 28 deletions(-)

diff --git a/l3sys-query.lua b/l3sys-query.lua
index 131db49..7eb1db6 100755
--- a/l3sys-query.lua
+++ b/l3sys-query.lua
@@ -161,8 +161,7 @@ end
 -- Remove '...' or :...: around an entire text:
 -- we need this to support restricted shell escape on Windows
 local function dequote(text)
-  if (match(text,"^'") and match(text,"'$")) or
-     (match(text,"^:") and match(text,":$")) then
+  if (match(text,"^'") and match(text,"'$")) then
     return sub(text,2,-2)
   end
   return text
diff --git a/l3sys-query.tex b/l3sys-query.tex
index 2279dd5..2795c0b 100644
--- a/l3sys-query.tex
+++ b/l3sys-query.tex
@@ -206,8 +206,6 @@ The handling of wildcards needs some further comment for those using
 \texttt{l3sys-query} from the command line: the \pkg{expl3} interface described
 in Section~\ref{sec:expl3} handles this aspect automatically for the user.
 
-\subsection{Shell use}
-
 On macOS and Linux, the shell normally expands globs, which include the
 wildcards |*| and |?|, before passing arguments to the appropriate command. This
 can be suppressed by surrounding the argument with |'| characters, hence the
@@ -218,23 +216,13 @@ formulation
 earlier.
 
 On Windows, the shell does no expansion, and thus arguments are passed as-is to
-the relevant command. However, in the \TeX{}~Live implementation of
-\texttt{texlua}, the script interpreter expands |*| and |?| \emph{before} they
-are made available to the script itself. This can only be suppressed by
-including one or more characters that prevent a match: this causes the
-\emph{entire} argument to be passed to the script, including whatever
-\enquote{extra} characters are used. Importantly, |'| has no special meaning
-here.
-
-To allow quoting of wildcards from the shell in a platform-neutral manner,
-\texttt{l3sys-query} will strip exactly one set of |'| characters around
-each argument before further processing.
-
-\subsection{Calls \emph{via} restricted shell escape}
+the relevant command. As such, |'| has no special meaning here. However, to
+allow quoting of wildcards from the shell in a platform-neutral manner,
+\texttt{l3sys-query} will strip exactly one set of |'| characters around each
+argument before further processing.
 
 Restricted shell escape prevents shell expansion of wildcards entirely, but
-also strips out all |'| characters from arguments. Thus on macOS and
-Linux, a \TeX{} call such as
+also strips out all |'| characters from arguments. Thus a \TeX{} call such as
 \begin{verbatim}
   \input|"l3sys-query ls '*.png'"
 \end{verbatim}
@@ -242,15 +230,6 @@ will work as it is converted to one without the |'| characters (the surrounding
 |"| are needed to allow space-separated arguments to be passed as a whole to
 |\input|).
 
-On Windows, the rules of restricted shell escape mean that |'| cannot be
-used here to prevent expansion of |*| and |?|. Rather, the character |:|
-should be used: this is reserved on Windows in any case. Thus one would use
-\begin{verbatim}
-  \input|"l3sys-query ls :*.png:"
-\end{verbatim}
-on Windows; \texttt{l3sys-query} and strips out exactly one set of surrounding
-|:| characters.
-
 \section{The \LaTeX{} interface\label{sec:expl3}}
 
 Using \texttt{l3sys-query} is not tied to access \emph{via} \pkg{expl3}, but