You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by nd...@apache.org on 2003/07/14 14:37:25 UTC
cvs commit: httpd-2.0/docs/manual/mod mod_actions.xml

nd          2003/07/14 05:37:25

  Modified:    docs/manual/mod mod_actions.xml
  Log:
  document new Action modifier
  
  Revision  Changes    Path
  1.10      +17 -1     httpd-2.0/docs/manual/mod/mod_actions.xml
  
  Index: mod_actions.xml
  ===================================================================
  RCS file: /home/cvs/httpd-2.0/docs/manual/mod/mod_actions.xml,v
  retrieving revision 1.9
  retrieving revision 1.10
  diff -u -r1.9 -r1.10
  --- mod_actions.xml	11 Apr 2003 01:25:51 -0000	1.9
  +++ mod_actions.xml	14 Jul 2003 12:37:25 -0000	1.10
  @@ -30,12 +30,14 @@
   <name>Action</name>
   <description>Activates a CGI script for a particular handler or
   content-type</description>
  -<syntax>Action <var>action-type</var> <var>cgi-script</var></syntax>
  +<syntax>Action <var>action-type</var> <var>cgi-script</var> [virtual]</syntax>
   <contextlist>
   <context>server config</context><context>virtual host</context>
   <context>directory</context><context>.htaccess</context>
   </contextlist>
   <override>FileInfo</override>
  +<compatibility>The <code>virtual</code> modifier was introduced in Apache
  +2.1</compatibility>
   
   <usage>
       <p>This directive adds an action, which will activate
  @@ -66,6 +68,20 @@
       <p>In the second example, requests for files with a file extension of
       <code>.xyz</code> are handled instead by the specified cgi script 
       <code>/cgi-bin/program.cgi</code>.</p>
  +
  +    <p>The optional <code>virtual</code> modifier turns off the check
  +    whether the requested file really exists. This is useful, for example,
  +    if you want to use the <directive>Action</directive> directive in
  +    virtual locations.</p>
  +
  +    <example><title>Example</title>
  +      &lt;Location /news&gt;<br />
  +      <indent>
  +        SetHandler news-handler
  +        Action news-handler /cgi-bin/news.cgi virtual
  +      </indent>
  +      &lt;/Location&gt;
  +    </example>
   </usage>
   
   <seealso><directive module="mod_mime">AddHandler</directive></seealso>