# HG changeset patch
# User Bruno Haible <bruno@clisp.org>
# Date 1336814717 -7200
# Node ID ae444fc808400c33b85bbdd4d7865529f72efaf3
# Parent  53fb1ea35cc9b441820ea4e1f34dd394788b04d7
sh-quote, system-quote: Add comments about wildcards.

* lib/sh-quote.h: Clarify what happens with wildcard characters.
* lib/system-quote.h: Likewise.
Reported by Eli Zaretskii <eliz@gnu.org>.

diff --git a/ChangeLog b/ChangeLog
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2012-05-12  Bruno Haible  <bruno@clisp.org>
+
+	sh-quote, system-quote: Add comments about wildcards.
+	* lib/sh-quote.h: Clarify what happens with wildcard characters.
+	* lib/system-quote.h: Likewise.
+	Reported by Eli Zaretskii <eliz@gnu.org>.
+
 2012-05-11  Paul Eggert  <eggert@cs.ucla.edu>
 
 	fsusage: check for GNU/Linux statvfs problem dynamically
diff --git a/lib/sh-quote.h b/lib/sh-quote.h
--- a/lib/sh-quote.h
+++ b/lib/sh-quote.h
@@ -20,7 +20,7 @@
 
 /* When passing a command to a shell, we must quote the program name and
    arguments, since Unix shells interpret characters like " ", "'", "<", ">",
-   "$" etc. in a special way.  */
+   "$", '*', '?' etc. in a special way.  */
 
 #include <stddef.h>
 
diff --git a/lib/system-quote.h b/lib/system-quote.h
--- a/lib/system-quote.h
+++ b/lib/system-quote.h
@@ -20,14 +20,16 @@
 
 /* When passing a command the system's command interpreter, we must quote the
    program name and arguments, since
-     - Unix shells interpret characters like " ", "'", "<", ">", "$" etc. in a
-       special way,
+     - Unix shells interpret characters like " ", "'", "<", ">", "$", '*', '?'
+       etc. in a special way,
      - Windows CreateProcess() interprets characters like ' ', '\t', '\\', '"'
        etc. (but not '<' and '>') in a special way,
      - Windows cmd.exe also interprets characters like '<', '>', '&', '%', etc.
        in a special way.  Note that it is impossible to pass arguments that
        contain newlines or carriage return characters to programs through
-       cmd.exe.  */
+       cmd.exe.
+     - Windows programs usually perform wildcard expansion when they receive
+       arguments that contain unquoted '*', '?' characters.  */
 
 #include <stddef.h>