Index: en/reference/curl/functions/curl-exec.xml
===================================================================
RCS file: /repository/phpdoc/en/reference/curl/functions/curl-exec.xml,v
retrieving revision 1.5
diff -u -r1.5 curl-exec.xml
--- en/reference/curl/functions/curl-exec.xml	27 Feb 2004 05:38:35 -0000	1.5
+++ en/reference/curl/functions/curl-exec.xml	8 Sep 2006 15:39:47 -0000
@@ -6,9 +6,10 @@
     <refname>curl_exec</refname>
     <refpurpose>Perform a CURL session</refpurpose>
    </refnamediv>
-   <refsect1>
-    <title>Description</title>
-     <methodsynopsis>
+
+   <refsect1 role="description">
+    &reftitle.description;
+    <methodsynopsis>
       <type>mixed</type><methodname>curl_exec</methodname>
       <methodparam><type>resource</type><parameter>ch</parameter></methodparam>
      </methodsynopsis>
@@ -17,6 +18,20 @@
      session and all the options for the session are set.  Its purpose
      is simply to execute the predefined CURL session (given by the
      <parameter>ch</parameter>).
+    </para>
+   </refsect1>
+
+   <refsect1 role="returnvalues">
+    &reftitle.returnvalues;
+    <para>
+     &return.success; However, if the CURLOPT_RETURNTRANSFER option is set,
+     it will return the result on success, &false; on failure.
+    </para>
+   </refsect1>
+   
+   <refsect1 role="examples">
+    &reftitle.examples;
+    <para>
      <example>
       <title>
        Initializing a new CURL session and fetching a webpage
@@ -41,13 +56,6 @@
       </programlisting>
      </example>
     </para>
-    <note>
-     <para>
-      If you want to have the result returned instead of it being printed to the
-      browser directly, use the CURLOPT_RETURNTRANSFER option of
-      <function>curl_setopt</function>.
-     </para>
-    </note>
    </refsect1>
   </refentry>