From beff461a87a9beae1abc9b93fb70f8d9faddf7d5 Mon Sep 17 00:00:00 2001
From: Sean Coates <sean@php.net>
Date: Wed, 15 Jun 2005 22:15:55 +0000
Subject: [PATCH] Document curl_copy_handle() #Patch from Tom Westcott

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@188490 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/curl/functions/curl-copy-handle.xml | 32 +++++++++++++++++--
 1 file changed, 30 insertions(+), 2 deletions(-)

diff --git a/reference/curl/functions/curl-copy-handle.xml b/reference/curl/functions/curl-copy-handle.xml
index 74b0e847c8..b2184a7751 100644
--- a/reference/curl/functions/curl-copy-handle.xml
+++ b/reference/curl/functions/curl-copy-handle.xml
@@ -1,5 +1,5 @@
 <?xml version='1.0' encoding='iso-8859-1'?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
 <refentry id="function.curl-copy-handle">
  <refnamediv>
   <refname>curl_copy_handle</refname>
@@ -13,9 +13,37 @@
    <type>resource</type><methodname>curl_copy_handle</methodname>
    <methodparam><type>resource</type><parameter>ch</parameter></methodparam>
   </methodsynopsis>
+  <para>
+   This function copy's a cURL handle.
+   Returning a new cURL handle with the same preferences.
+  </para>
+  <para>
+   <example>
+    <title>Copying a cURL handle.</title>
+     <programlisting role="php">
+<![CDATA[
+<?php
+// create a new curl resource
+$ch = curl_init();
 
-  &warn.undocumented.func;
+// set URL and other appropriate options
+curl_setopt($ch, CURLOPT_URL, 'http://www.example.com/');
+curl_setopt($ch, CURLOPT_HEADER, 0);
 
+// copy the handle
+$ch2 = curl_copy_handle($ch);
+
+// grab URL (http://www.example.com/) and pass it to the browser
+curl_exec($ch2);
+
+// close curl resources, and free up system resources
+curl_close($ch2);
+curl_close($ch);
+?>
+]]>
+     </programlisting>
+    </example>
+   </para>
  </refsect1>
 </refentry>