[latex3-commits] [latex3/l3sys-query] 2e: Re-wrap lines (f6a3025)
github at latex-project.org
github at latex-project.org
Mon Mar 11 17:23:33 CET 2024
Repository : https://github.com/latex3/l3sys-query
On branch : 2e
Link : https://github.com/latex3/l3sys-query/commit/f6a3025dbd9c9da87456268218e85296b820523f
>---------------------------------------------------------------
commit f6a3025dbd9c9da87456268218e85296b820523f
Author: Joseph Wright <joseph at texdev.net>
Date: Mon Mar 11 11:49:50 2024 +0000
Re-wrap lines
>---------------------------------------------------------------
f6a3025dbd9c9da87456268218e85296b820523f
l3sys-query.tex | 28 ++++++++++++++--------------
1 file changed, 14 insertions(+), 14 deletions(-)
diff --git a/l3sys-query.tex b/l3sys-query.tex
index d519f30..5ac660f 100644
--- a/l3sys-query.tex
+++ b/l3sys-query.tex
@@ -216,9 +216,9 @@ The handling of wildcards needs some further comment for those using
in Section~\ref{sec:expl3} handles this aspect automatically for the user.
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
-formulation
+wildcards |*| and |?|, before passing arguments to the appropriate command.
+This can be suppressed by surrounding the argument with |'| characters, hence
+the formulation
\begin{verbatim}
l3sys-query ls '*.png'
\end{verbatim}
@@ -231,31 +231,31 @@ allow quoting of wildcards from the shell in a platform-neutral manner,
argument before further processing.
It is not possible to use |"| quotes at all in the argument passed to
-|l3sys-query| from \TeX, as the \TeX\ system removes all |"| in |\input|
-while handling space quoting.
+|l3sys-query| from \TeX, as the \TeX\ system removes all |"| in |\input| while
+handling space quoting.
Restricted shell escape prevents shell expansion of wildcards entirely. On
-non-Windows systems, it does this by ensuring
-that each argument is |'| quoted to ensure further expansion.
-Thus a \TeX{} call such as
+non-Windows systems, it does this by ensuring that each argument is |'| quoted
+to ensure further expansion. Thus a \TeX{} call such as
\begin{verbatim}
\input|"l3sys-query ls '*.png'"
\end{verbatim}
-will work if |--shell-escape| is used as the argument is passed directly to the shell, but
-in restricted shell escape will give an error such as:
+will work if |--shell-escape| is used as the argument is passed directly to the
+shell, but in restricted shell escape will give an error such as:
\begin{verbatim}
! I can't find file `"|l3sys-query ls '*.png'"'.
\end{verbatim}
-The \LaTeX\ interfaces described below adust the quoting used depending on the |shell-escape| status.
+The \LaTeX\ interfaces described below adust the quoting used depending on the
+|shell-escape| status.
\section{The \LaTeX{} interface\label{sec:expl3}}
Using \texttt{l3sys-query} is not tied to access \emph{via} \pkg{expl3}, but
this is the preferred approach for the \LaTeX{} Team. Details of how to use
\texttt{l3sys-query} as an \pkg{expl3} programmer will covered in
-\texttt{interface3.pdf} once the macro code is finalised. A document level interface
-will also be provided via a \pkg{l3sys-query} package which is based on the \pkg{expl3}
-interface and will be described here.
+\texttt{interface3.pdf} once the macro code is finalised. A document level
+interface will also be provided via a \pkg{l3sys-query} package which is based
+on the \pkg{expl3} interface and will be described here.
\end{documentation}
More information about the latex3-commits
mailing list.