httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From rbo...@apache.org
Subject cvs commit: httpd-docs-1.3/htdocs/manual/mod mod_include.html
Date Sun, 20 Jan 2002 16:39:41 GMT
rbowen      02/01/20 08:39:41

  Modified:    htdocs/manual/mod mod_include.html
  Log:
  Based on a discussion on usenet, a little more detail regarding exec cgi
  and include virtual, with a few examples.
  
  Revision  Changes    Path
  1.39      +19 -3     httpd-docs-1.3/htdocs/manual/mod/mod_include.html
  
  Index: mod_include.html
  ===================================================================
  RCS file: /home/cvs/httpd-docs-1.3/htdocs/manual/mod/mod_include.html,v
  retrieving revision 1.38
  retrieving revision 1.39
  diff -u -r1.38 -r1.39
  --- mod_include.html	20 Jan 2002 14:43:56 -0000	1.38
  +++ mod_include.html	20 Jan 2002 16:39:41 -0000	1.39
  @@ -200,7 +200,8 @@
               output, then this will be translated into an HTML
               anchor.</p>
   
  -            <p>The <code>include virtual</code> element should be
  +            <p>The <code><a href="#includevirtual">include
  +            virtual</a></code> element should be
               used in preference to <code>exec cgi</code>. In particular,
               if you need to pass additional arguments to a CGI program,
               using the query string, this cannot be done with <code>exec
  @@ -219,7 +220,8 @@
             to the command, in addition to the usual set of CGI 
             variables.</p>
   
  -        <p>The use of <code>#include virtual</code> is almost always
  +        <p>The use of <code><a href="#includevirtual">#include 
  +        virtual</a></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
  @@ -291,10 +293,13 @@
             <dd>The value is a path relative to the directory
             containing the current document being parsed. It cannot
             contain <code>../</code>, nor can it be an absolute path.
  +          Therefore, you cannot include files that are outside of the
  +          document root, or above the current document in the directory
  +          structure.
             The <code>virtual</code> attribute should always be used
             in preference to this one.</dd>
   
  -          <dt><strong>virtual</strong></dt>
  +          <dt><strong><a name="includevirtual">virtual</a></strong></dt>
   
            <dd>
             <p>The value is a (%-encoded) URL relative to the
  @@ -307,6 +312,17 @@
              server would return if the URL were accessed by the client
              is included in the parsed output. Thus included files can
              be nested.</p>
  +
  +           <p>If the specified URL is a CGI program, the program will
  +           be executed and its output inserted in place of the directive
  +           in the parsed file. You may include a query string in a CGI
  +           url:</p>
  +     
  +     <code>&lt;!--#include virtual="/cgi-bin/example.cgi?argument=value" --&gt;</code>
  +           
  +           <p><code>include virtual</code> should be used in preference
  +           to <code>exec cgi</code> to include the output of CGI
  +           programs into an HTML document.
             </dd>
           </dl>
         </dd>
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


Mime
View raw message