Index: apache-setenv.xml
===================================================================
RCS file: /repository/phpdoc/en/reference/apache/functions/apache-setenv.xml,v
retrieving revision 1.2
diff -u -r1.2 apache-setenv.xml
--- apache-setenv.xml	17 Apr 2002 06:36:20 -0000	1.2
+++ apache-setenv.xml	21 Aug 2004 11:58:41 -0000
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
 <!-- splitted from ./en/functions/apache.xml, last change in rev 1.7 -->
   <refentry id="function.apache-setenv">
    <refnamediv>
@@ -8,14 +8,41 @@
    </refnamediv>
    <refsect1>
     <title>Description</title>
-     <methodsynopsis>
-      <type>int</type><methodname>apache_setenv</methodname>
-      <methodparam><type>string</type><parameter>variable</parameter></methodparam>
-      <methodparam><type>string</type><parameter>value</parameter></methodparam>
-      <methodparam choice="opt"><type>bool</type><parameter>walk_to_top</parameter></methodparam>
-     </methodsynopsis>
+    <methodsynopsis>
+     <type>int</type><methodname>apache_setenv</methodname>
+     <methodparam><type>string</type><parameter>variable</parameter></methodparam>
+     <methodparam><type>string</type><parameter>value</parameter></methodparam>
+     <methodparam choice="opt"><type>bool</type><parameter>walk_to_top</parameter></methodparam>
+    </methodsynopsis>
     <para>
-     &warn.undocumented.func;
+     <function>apache_setenv</function> sets the value of the Apache
+     environment variable specified by
+     <parameter>variable</parameter>.
+    </para>
+    <note>
+     <para>
+      When setting an Apache environment variable, the corresponding $_SERVER
+      variable is not changed.
+     </para>
+    </note>
+    <example>
+     <title>Setting an Apache environment variable using <function>apache_setenv</function></title>
+     <programlisting role="php">
+<![CDATA[
+<?php
+apache_setenv("EXAMPLE_VAR", "Example Value");
+?>
+]]>
+     </programlisting>
+    </example>
+    <para>
+     <function>apache_setenv</function> can be paired up with
+     <function>apache_getenv</function> across seperate pages or for setting
+     variables to pass to Server Side Includes (.shtml) that have been
+     included in PHP scripts.
+    </para>
+    <para>
+     See also <function>apache_getenv</function>.
     </para>
    </refsect1>
   </refentry>