Implemented the new doc style and some rewording where appropriate

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@217366 c90b9560-bf6c-de11-be94-00142212c4b1

reference/strings/functions/strlen.xml

@@ -1,13 +1,13 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.6 $ -->
+<!-- $Revision: 1.7 $ -->
 <refentry id="function.strlen">
  <refnamediv>
   <refname>strlen</refname>
   <refpurpose>Get string length</refpurpose>
  </refnamediv>
- 
- <refsect1>
-  <title>Description</title>
+
+ <refsect1 role="description">
+  &reftitle.description;
   <methodsynopsis>
    <type>int</type><methodname>strlen</methodname>
    <methodparam><type>string</type><parameter>string</parameter></methodparam>
@@ -15,6 +15,34 @@
   <para>
    Returns the length of the given <parameter>string</parameter>.
   </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>string</parameter></term>
+     <listitem>
+      <para>
+       The <type>string</type> being measured for length.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   The length of the <parameter>string</parameter> on success, 
+   and <literal>0</literal> if the <parameter>string</parameter> is empty.
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
   <para>
    <example>
     <title>A <function>strlen</function> example</title>
@@ -31,8 +59,15 @@ echo strlen($str); // 7
     </programlisting>
    </example>
   </para>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
   <para>
-   See also <function>count</function>, and <function>mb_strlen</function>.
+   <simplelist>
+    <member><function>count</function></member>
+    <member><function>mb_strlen</function></member>
+   </simplelist>
   </para>
  </refsect1>
 </refentry>