add some comments pertaining to the use of apr_tokenize_to_argv for

building the command-line to the external program

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@96507 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/docs/manual/mod/mod_ext_filter.html.en b/docs/manual/mod/mod_ext_filter.html.en
index 73d99f6dc267ced0105aa113b7d75a427ef717b9..9fff06cb2c0cb5a1236cbf2a9f49d9c5ee817e99 100644 (file)
--- a/docs/manual/mod/mod_ext_filter.html.en
+++ b/docs/manual/mod/mod_ext_filter.html.en
@@ -196,10 +196,13 @@ close(SAVE);
       program name, the command line should be surrounded in
       quotation marks (e.g., <em>cmd="/bin/mypgm arg1 arg2"</em>.
       Normal shell quoting is not necessary since the program is
-      run directly, bypassing the shell.  In addition to the 
-      standard CGI environment variables, DOCUMENT_URI,
-      DOCUMENT_PATH_INFO, and QUERY_STRING_UNESCAPED will also be set
-      for the program.</dd>
+      run directly, bypassing the shell.  Program arguments are
+      blank-delimited.  A backslash can be used to escape blanks 
+      which should be part of a program argument.  Any backslashes
+      which are part of the argument must be escaped with backslash
+      themselves.  In addition to the standard CGI environment 
+      variables, DOCUMENT_URI, DOCUMENT_PATH_INFO, and 
+      QUERY_STRING_UNESCAPED will also be set for the program.</dd>
 
       <dt>mode=<em>mode</em></dt>
 

diff --git a/docs/manual/mod/mod_ext_filter.xml b/docs/manual/mod/mod_ext_filter.xml
index cd810c6e099a7fb13c2c31600a0445a0b29a5a53..51895dafb943dafabf88e5556eb8de729407a15d 100644 (file)
--- a/docs/manual/mod/mod_ext_filter.xml
+++ b/docs/manual/mod/mod_ext_filter.xml
@@ -204,10 +204,13 @@ close(SAVE);
       program name, the command line should be surrounded in
       quotation marks (e.g., <em>cmd="/bin/mypgm arg1 arg2"</em>.
       Normal shell quoting is not necessary since the program is
-      run directly, bypassing the shell.  In addition to the 
-      standard CGI environment variables, DOCUMENT_URI,
-      DOCUMENT_PATH_INFO, and QUERY_STRING_UNESCAPED will also be set
-      for the program.</dd>
+      run directly, bypassing the shell.  Program arguments are
+      blank-delimited.  A backslash can be used to escape blanks 
+      which should be part of a program argument.  Any backslashes
+      which are part of the argument must be escaped with backslash
+      themselves.  In addition to the standard CGI environment 
+      variables, DOCUMENT_URI, DOCUMENT_PATH_INFO, and 
+      QUERY_STRING_UNESCAPED will also be set for the program.</dd>
 
       <dt>mode=<em>mode</em></dt>