On Sat, 19 Jan 2002, Rich Bowen wrote:
> Yes, I will add a comment of that nature to my patch, althoght there is,
> I believe, already a comment like this in the #exec cgi documentation.
OK, here's my revised patch:
diff -B -b -u -r1.36 mod_include.html
--- mod_include.html 11 Nov 2001 03:24:01 -0000 1.36
+++ mod_include.html 20 Jan 2002 02:29:12 -0000
@@ -201,9 +201,27 @@
<dt>cmd</dt>
- <dd>The server will execute the given string using
+ <dd>
+ <p>The server will execute the given string using
<code>/bin/sh</code>. The include variables are available
- to the command.</dd>
+ to the command.</p>
+
+ <p>The use of <code>#include virtual</code> is almost always
+ prefered to using either <code>#exec cgi</code> or <code>#exec
+ cmd</code>. The former (<code>#include virtual</code>) used the
+ standard Apache sub-request mechanism to include files or
+ scripts. It is much better tested and maintained.</p>
+
+ <p>In addition, on some platforms, like Win32, and on unix
+ when using suexec, you cannot pass arguments to a command in
+ an <code>exec</code> directive, or otherwise include spaces in
+ the command. Thus, while the following will work under a
+ non-suexec configuration on unix, it will not produce the
+ desired result under Win32, or when running suexec:</p>
+
+ <code><!--#exec cmd="perl /path/to/perlscript arg1 arg2" --></code>
+
+ </dd>
</dl>
</dd>
--
Oh I have slipped the surly bonds of earth
And danced the sky on laughter-silvered wings
--High Flight (John Gillespie Magee)
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
