From c0868bb941c2f6ad2b3d0b61cef2271a134b05eb Mon Sep 17 00:00:00 2001
From: Christopher Jones <sixd@php.net>
Date: Wed, 13 Jan 2010 01:42:13 +0000
Subject: [PATCH] Annotate example

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@293475 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/oci8/functions/oci-set-client-identifier.xml | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/reference/oci8/functions/oci-set-client-identifier.xml b/reference/oci8/functions/oci-set-client-identifier.xml
index 581e676e74..41ac35706e 100644
--- a/reference/oci8/functions/oci-set-client-identifier.xml
+++ b/reference/oci8/functions/oci-set-client-identifier.xml
@@ -70,18 +70,23 @@
     <title>Setting the client identifier to the application user</title>
     <programlisting role="php">
 <![CDATA[
-...
 <?php
 
+// Find the application user's login name
 session_start();
 $un = my_validate_session($_SESSION['username']);
 $c = oci_connect('myschema', 'welcome', 'localhost/XE');
+
+// Tell Oracle who that user is
 oci_set_client_identifier($c, $un);
 
+// The next roundtrip to the database will piggyback the identifier
 $s = oci_parse($c, 'select mydata from mytable');
+oci_execute($s);
+
+...
 
 ?>
-...
 ]]>
     </programlisting>
    </example>