From 196836d7acb3fbc0e8f1ece92ebde8e698479971 Mon Sep 17 00:00:00 2001
From: Moriyoshi Koizumi <moriyoshi@php.net>
Date: Sun, 2 Nov 2003 19:08:41 +0000
Subject: [PATCH] Initial documentation

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@143617 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/iconv/functions/iconv-strpos.xml | 30 +++++++++++++++++++---
 1 file changed, 26 insertions(+), 4 deletions(-)

diff --git a/reference/iconv/functions/iconv-strpos.xml b/reference/iconv/functions/iconv-strpos.xml
index 3247de2bda..e0840d699f 100644
--- a/reference/iconv/functions/iconv-strpos.xml
+++ b/reference/iconv/functions/iconv-strpos.xml
@@ -1,25 +1,47 @@
 <?xml version='1.0' encoding='iso-8859-1'?>
-<!-- $Revision: 1.1 $ -->
+<!-- $Revision: 1.2 $ -->
 <!-- Generated by xml_proto.php v2.0. Found in /scripts directory of phpdoc. -->
   <refentry id="function.iconv-strpos">
    <refnamediv>
     <refname>iconv_strpos</refname>
     <refpurpose>
-     Finds position of first occurrence of needle within part of haystack beginning with offset
+     Finds position of first occurrence of a needle within a haystack.
     </refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
     <methodsynopsis>
-     <type>string</type><methodname>iconv_strpos</methodname>
+     <type>int</type><methodname>iconv_strpos</methodname>
      <methodparam><type>string</type><parameter>haystack</parameter></methodparam>
      <methodparam><type>string</type><parameter>needle</parameter></methodparam>
      <methodparam><type>int</type><parameter>offset</parameter></methodparam>
      <methodparam choice="opt"><type>string</type><parameter>charset</parameter></methodparam>
     </methodsynopsis>
+    <para>
+      Returns the numeric position of the first occurrence of
+      <parameter>needle</parameter> in <parameter>haystack</parameter>.
+    </para>
+    <para>
+      The optional <parameter>offset</parameter> parameter specifies
+      the position from which the search should be performed.
+    </para>
+    <para>
+      If <parameter>needle</parameter> is not found,
+      <function>strpos</function> will return &false;.
+    </para>
 
-     &warn.undocumented.func;
+    &return.falseproblem;
 
+    <para>
+      If <parameter>haystack</parameter> or <parameter>needle</parameter> is
+      not a string, it is converted to an integer and applied as the ordinal
+      value of a character.
+    </para>
+
+    <para>
+      See also <function>strpos</function> and
+      <function>iconv_strrpos</function>.
+    </para>
    </refsect1>
   </refentry>