[PHP-DOC] cvs: phpdoc /en/functions strings.xml From: Egon Schmid (eschmid <email protected>)
Date: 07/05/00

eschmid Wed Jul 5 02:45:05 2000 EDT

  Modified files:
    /phpdoc/en/functions strings.xml
  Log:
  Some cleanup.
  
Index: phpdoc/en/functions/strings.xml
diff -u phpdoc/en/functions/strings.xml:1.23 phpdoc/en/functions/strings.xml:1.24
--- phpdoc/en/functions/strings.xml:1.23 Sat Jul 1 14:36:42 2000
+++ phpdoc/en/functions/strings.xml Wed Jul 5 02:45:05 2000
@@ -13,7 +13,7 @@
   <refentry id="function.addcslashes">
    <refnamediv>
     <refname>AddCSlashes</refname>
- <refpurpose>Quote string with slashes in a C style.</refpurpose>
+ <refpurpose>Quote string with slashes in a C style</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -108,7 +108,7 @@
   <refentry id="function.chop">
    <refnamediv>
     <refname>Chop</refname>
- <refpurpose>Remove trailing whitespace.</refpurpose>
+ <refpurpose>Remove trailing whitespace</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -137,7 +137,7 @@
   <refentry id="function.chr">
    <refnamediv>
     <refname>Chr</refname>
- <refpurpose>Return a specific character.</refpurpose>
+ <refpurpose>Return a specific character</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -170,7 +170,7 @@
   <refentry id="function.chunk-split">
    <refnamediv>
     <refname>chunk_split</refname>
- <refpurpose>Split a string into smaller chunks.</refpurpose>
+ <refpurpose>Split a string into smaller chunks</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -217,7 +217,7 @@
    <refnamediv>
     <refname>convert_cyr_string</refname>
     <refpurpose>
- Convert from one Cyrillic character set to another.
+ Convert from one Cyrillic character set to another
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -276,7 +276,7 @@
    <refnamediv>
     <refname>count_chars</refname>
     <refpurpose>
- Return information abouts characters used in a string.
+ Return information abouts characters used in a string
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -340,7 +340,7 @@
   <refentry id="function.crypt">
    <refnamediv>
     <refname>crypt</refname>
- <refpurpose>DES-encrypt a string.</refpurpose>
+ <refpurpose>DES-encrypt a string</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -421,7 +421,7 @@
   <refentry id="function.echo">
    <refnamediv>
     <refname>echo</refname>
- <refpurpose>Output one or more strings.</refpurpose>
+ <refpurpose>Output one or more strings</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -481,7 +481,9 @@
       <funcdef>array <function>explode</function></funcdef>
       <paramdef>string <parameter>separator</parameter></paramdef>
       <paramdef>string <parameter>string</parameter></paramdef>
- <paramdef>int <parameter><optional>limit</optional></parameter></paramdef>
+ <paramdef>int
+ <parameter><optional>limit</optional></parameter>
+ </paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
@@ -511,7 +513,7 @@
   <refentry id="function.flush">
    <refnamediv>
     <refname>flush</refname>
- <refpurpose>Flush the output buffer.</refpurpose>
+ <refpurpose>Flush the output buffer</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -535,7 +537,7 @@
     <refpurpose>
      Returns the translation table used by
      <function>htmlspecialchars</function> and
- <function>htmlentities</function>.
+ <function>htmlentities</function>
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -599,7 +601,7 @@
     <refname>get_meta_tags</refname>
     <refpurpose>
      Extracts all meta tag content attributes from a file and returns
- an array.
+ an array
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -646,7 +648,7 @@
    <refnamediv>
     <refname>htmlentities</refname>
     <refpurpose>
- Convert all applicable characters to HTML entities.
+ Convert all applicable characters to HTML entities
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -677,7 +679,7 @@
    <refnamediv>
     <refname>htmlspecialchars</refname>
     <refpurpose>
- Convert special characters to HTML entities.
+ Convert special characters to HTML entities
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -771,7 +773,7 @@
   <refentry id="function.join">
    <refnamediv>
     <refname>join</refname>
- <refpurpose>Join array elements with a string.</refpurpose>
+ <refpurpose>Join array elements with a string</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -797,7 +799,7 @@
    <refnamediv>
     <refname>levenshtein</refname>
     <refpurpose>
- Calculate Levenshtein distance between two strings
+ Calculate Levenshtein distance between two strings
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -810,26 +812,25 @@
      </funcprototype>
     </funcsynopsis>
     <para>
- This function return the Levenshtein-Distance between the
- two argument strings or -1, if one of the argument strings
- is longer than the limit of 255 characters.
+ This function return the Levenshtein-Distance between the two
+ argument strings or -1, if one of the argument strings is longer
+ than the limit of 255 characters.
     </para>
     <para>
- The Levenshtein distance is defined as the minimal number
- of characters you have to replace, insert or delete to
- transform <parameter>str1</parameter> into
- <parameter>str2</parameter>.
+ The Levenshtein distance is defined as the minimal number of
+ characters you have to replace, insert or delete to transform
+ <parameter>str1</parameter> into <parameter>str2</parameter>.
      The complexity of the algorithm is <literal>O(m*n)</literal>,
      where <literal>n</literal> and <literal>m</literal> are the
- length of <parameter>str1</parameter> and
+ length of <parameter>str1</parameter> and
      <parameter>str2</parameter> (rather good when compared to
- <function>similar_text</function>, which is O(max(n,m)**3),
- but still expensive).
+ <function>similar_text</function>, which is O(max(n,m)**3), but
+ still expensive).
     </para>
     <para>
- See also <function>soundex</function>,
- <function>similar_text</function>
- and <function>metaphone</function>.
+ See also <function>soundex</function>,
+ <function>similar_text</function> and
+ <function>metaphone</function>.
     </para>
    </refsect1>
   </refentry>
@@ -838,7 +839,7 @@
    <refnamediv>
     <refname>ltrim</refname>
     <refpurpose>
- Strip whitespace from the beginning of a string.
+ Strip whitespace from the beginning of a string
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -864,7 +865,7 @@
   <refentry id="function.md5">
    <refnamediv>
     <refname>md5</refname>
- <refpurpose>Calculate the md5 hash of a string.</refpurpose>
+ <refpurpose>Calculate the md5 hash of a string</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -885,7 +886,7 @@
   <refentry id="function.metaphone">
    <refnamediv>
     <refname>Metaphone</refname>
- <refpurpose>Calculate the metaphone key of a string.</refpurpose>
+ <refpurpose>Calculate the metaphone key of a string</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -922,7 +923,7 @@
   <refentry id="function.nl2br">
    <refnamediv>
     <refname>nl2br</refname>
- <refpurpose>Converts newlines to HTML line breaks.</refpurpose>
+ <refpurpose>Converts newlines to HTML line breaks</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -946,35 +947,33 @@
   <refentry id="function.ob-start">
    <refnamediv>
     <refname>ob_start</refname>
- <refpurpose>
- Turn on output buffering
- </refpurpose>
+ <refpurpose>Turn on output buffering</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
     <funcsynopsis>
      <funcprototype>
       <funcdef>void <function>ob_start</function></funcdef>
- <void/>
+ <void/>
      </funcprototype>
     </funcsynopsis>
+ <para>
+ This function will turn output buffering. While output buffering
+ is active there will be no rel output from the script, the output
+ is appended to an internal buffer instead.
+ </para>
     <para>
- This function will turn output buffering. While output buffering
- is active there will be no rel output from the script, the output
- is appended to an internal buffer instead.
+ The contents of this internal buffer may be copied into a string
+ variable using <function>ob_get_contents</function>. Real output
+ happens when <function>ob_end_flush</function> is called and
+ <function>ob_end_clean</function> will just silently discard the
+ buffer contents.
     </para>
- <para>
- The contents of this internal buffer may be copied into a string
- variable using <function>ob_get_contents</function>.
- Real output happens when <function>ob_end_flush</function> is
- called and <function>ob_end_clean</function> will just silently
- discard the buffer contents.
- </para>
     <para>
      See also <function>ob_get_contents</function>,
- <function>ob_end_flush</function>,
- <function>ob_end_clean</function>
- and <function>ob_implicit_flush</function>
+ <function>ob_end_flush</function>,
+ <function>ob_end_clean</function> and
+ <function>ob_implicit_flush</function>
     </para>
    </refsect1>
   </refentry>
@@ -983,7 +982,7 @@
    <refnamediv>
     <refname>ob_get_contents</refname>
     <refpurpose>
- Return the contents of the output buffer
+ Return the contents of the output buffer
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -991,17 +990,17 @@
     <funcsynopsis>
      <funcprototype>
       <funcdef>string <function>ob_get_contents</function></funcdef>
- <void/>
+ <void/>
      </funcprototype>
     </funcsynopsis>
     <para>
- This will return the content of the output buffer
- or FALSE, if output buffering isn't active.
+ This will return the content of the output buffer or FALSE, if
+ output buffering isn't active.
     </para>
     <para>
      See also <function>ob_start</function>,
- <function>ob_end_flush</function>,
- and <function>ob_end_clean</function>.
+ <function>ob_end_flush</function>, and
+ <function>ob_end_clean</function>.
     </para>
    </refsect1>
   </refentry>
@@ -1010,7 +1009,7 @@
    <refnamediv>
     <refname>ob_end_flush</refname>
     <refpurpose>
- Flush (send) the output buffer and turn off output buffering
+ Flush (send) the output buffer and turn off output buffering
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -1018,30 +1017,30 @@
     <funcsynopsis>
      <funcprototype>
       <funcdef>void <function>ob_end_flush</function></funcdef>
- <void/>
+ <void/>
      </funcprototype>
     </funcsynopsis>
     <para>
- This function will send the contents of the output buffer
- (if any) and turn output buffering off.
- If you want to further process the buffers content you have
- to call <function>ob_get_contents</function> before
- <function>ob_end_flush</function> as the buffer contents
- get discarded after output.
+ This function will send the contents of the output buffer (if
+ any) and turn output buffering off. If you want to further
+ process the buffers content you have to call
+ <function>ob_get_contents</function> before
+ <function>ob_end_flush</function> as the buffer contents get
+ discarded after output.
     </para>
     <para>
      See also <function>ob_start</function>,
- <function>ob_get_contents</function>,
- and <function>ob_end_clean</function>.
+ <function>ob_get_contents</function>, and
+ <function>ob_end_clean</function>.
     </para>
    </refsect1>
   </refentry>
  
   <refentry id="function.ob-end-clean">
    <refnamediv>
- <refname>ob_end_clean</refname>
+ <refname>ob_end_clean</refname>
     <refpurpose>
- Clean (erase) the output buffer and turn off output buffering
+ Clean (erase) the output buffer and turn off output buffering
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -1049,16 +1048,16 @@
     <funcsynopsis>
      <funcprototype>
       <funcdef>void <function>ob_end_clean</function></funcdef>
- <void/>
+ <void/>
      </funcprototype>
     </funcsynopsis>
     <para>
- This function discards the content of the output buffer and
+ This function discards the content of the output buffer and
      turns off output buffering.
     </para>
     <para>
- See also <function>ob_start</function>
- and <function>ob_end_flush</function>.
+ See also <function>ob_start</function> and
+ <function>ob_end_flush</function>.
     </para>
    </refsect1>
   </refentry>
@@ -1067,32 +1066,35 @@
    <refnamediv>
     <refname>ob_implicit_flush</refname>
     <refpurpose>
- Turn implicit flush on/off
- </refpurpose>
+ Turn implicit flush on/off
+ </refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
     <funcsynopsis>
      <funcprototype>
       <funcdef>void <function>ob_implicit_flush</function></funcdef>
- <paramdef>int <parameter><optional>flag</optional></parameter></paramdef>
- </funcprototype>
+ <paramdef>int
+ <parameter><optional>flag</optional></parameter>
+ </paramdef>
+ </funcprototype>
     </funcsynopsis>
+ <para>
+ <function>ob_implicit_flush</function> will turn implicit
+ flushing on or off (if no <parameter>flag</parameter> is given,
+ it defaults to on). Implicit flushing will result in a flush
+ operation after every output call, so that explicit calls to
+ <function>flush</function> will no longer be needed.
+ </para>
     <para>
- <function>ob_implicit_flush</function> will turn implicit flushing on or off
- (if no <parameter>flag</parameter> is given, it defaults to on).
- Implicit flushing will result in a flush operation after every output call,
- so that explicit calls to <function>flush</function> will no longer be needed.
- </para>
- <para>
- Turning implicit flushing on will disable output buffering, the output buffers
- current output will be sent as if <function>ob_end_flush</function> had been
- called.
- </para>
+ Turning implicit flushing on will disable output buffering, the
+ output buffers current output will be sent as if
+ <function>ob_end_flush</function> had been called.
+ </para>
     <para>
      See also <function>flush</function>,
- <function>ob_start</function>
- and <function>ob_end_flush</function>.
+ <function>ob_start</function> and
+ <function>ob_end_flush</function>.
     </para>
    </refsect1>
   </refentry>
@@ -1100,7 +1102,7 @@
   <refentry id="function.ord">
    <refnamediv>
     <refname>Ord</refname>
- <refpurpose>Return ASCII value of character.</refpurpose>
+ <refpurpose>Return ASCII value of character</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -1132,7 +1134,7 @@
   <refentry id="function.parse-str">
    <refnamediv>
     <refname>parse_str</refname>
- <refpurpose>Parses the string into variables.</refpurpose>
+ <refpurpose>Parses the string into variables</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -1187,7 +1189,7 @@
   <refentry id="function.printf">
    <refnamediv>
     <refname>printf</refname>
- <refpurpose>Output a formatted string.</refpurpose>
+ <refpurpose>Output a formatted string</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -1215,7 +1217,7 @@
    <refnamediv>
     <refname>quoted_printable_decode</refname>
     <refpurpose>
- Convert a quoted-printable string to an 8 bit string.
+ Convert a quoted-printable string to an 8 bit string
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -1239,8 +1241,8 @@
 
   <refentry id="function.quotemeta">
    <refnamediv>
- <refname>QuoteMeta</refname>
- <refpurpose>quote meta characters</refpurpose>
+ <refname>quotemeta</refname>
+ <refpurpose>Quote meta characters</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -1294,7 +1296,7 @@
   <refentry id="function.rawurlencode">
    <refnamediv>
     <refname>rawurlencode</refname>
- <refpurpose>URL-encode according to RFC1738.</refpurpose>
+ <refpurpose>URL-encode according to RFC1738</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -1338,7 +1340,7 @@
   <refentry id="function.setlocale">
    <refnamediv>
     <refname>setlocale</refname>
- <refpurpose>Set locale information.</refpurpose>
+ <refpurpose>Set locale information</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -1411,7 +1413,7 @@
    <refnamediv>
     <refname>similar_text</refname>
     <refpurpose>
- Calculate the similarity between two strings.
+ Calculate the similarity between two strings
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -1635,7 +1637,7 @@
    <refnamediv>
     <refname>strcasecmp</refname>
     <refpurpose>
- Binary safe case-insensitive string comparison.
+ Binary safe case-insensitive string comparison
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -1657,7 +1659,7 @@
       <programlisting role="php">
 $var1 = "Hello";
 $var2 = "hello";
-if ( !strcasecmp($var1,$var2) ) {
+if (!strcasecmp ($var1, $var2)) {
     echo '$var1 is equal to $var2 in a case-insensitive string comparison';
 }
       </programlisting>
@@ -1675,7 +1677,7 @@
    <refnamediv>
     <refname>strchr</refname>
     <refpurpose>
- Find the first occurrence of a character.
+ Find the first occurrence of a character
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -1729,7 +1731,7 @@
    <refnamediv>
     <refname>strcspn</refname>
     <refpurpose>
- Find length of initial segment not matching mask.
+ Find length of initial segment not matching mask
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -1789,8 +1791,10 @@
 
   <refentry id="function.stripcslashes">
    <refnamediv>
- <refname>StripCSlashes</refname>
- <refpurpose>un-quote string quoted with addcslashes</refpurpose>
+ <refname>stripcslashes</refname>
+ <refpurpose>
+ Un-quote string quoted with <function>addcslashes</function>
+ </refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -1818,8 +1822,10 @@
 
   <refentry id="function.stripslashes">
    <refnamediv>
- <refname>StripSlashes</refname>
- <refpurpose>Un-quote string quoted with addslashes</refpurpose>
+ <refname>stripslashes</refname>
+ <refpurpose>
+ Un-quote string quoted with <function>addslashes</function>
+ </refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -1844,7 +1850,7 @@
    <refnamediv>
     <refname>stristr</refname>
     <refpurpose>
- Case-insensitive <function>strstr</function>.
+ Case-insensitive <function>strstr</function>
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -1880,7 +1886,7 @@
   <refentry id="function.strlen">
    <refnamediv>
     <refname>strlen</refname>
- <refpurpose>Get string length.</refpurpose>
+ <refpurpose>Get string length</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -1900,7 +1906,7 @@
    <refnamediv>
     <refname>strpos</refname>
     <refpurpose>
- Find position of first occurrence of a string.
+ Find position of first occurrence of a string
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -1970,7 +1976,7 @@
    <refnamediv>
     <refname>strrchr</refname>
     <refpurpose>
- Find the last occurrence of a character in a string.
+ Find the last occurrence of a character in a string
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -2020,7 +2026,7 @@
   <refentry id="function.str-repeat">
    <refnamediv>
     <refname>str_repeat</refname>
- <refpurpose>Repeat a string.</refpurpose>
+ <refpurpose>Repeat a string</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -2056,7 +2062,7 @@
   <refentry id="function.strrev">
    <refnamediv>
     <refname>strrev</refname>
- <refpurpose>Reverse a string.</refpurpose>
+ <refpurpose>Reverse a string</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -2076,7 +2082,7 @@
    <refnamediv>
     <refname>strrpos</refname>
     <refpurpose>
- Find position of last occurrence of a char in a string.
+ Find position of last occurrence of a char in a string
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -2115,7 +2121,7 @@
    <refnamediv>
     <refname>strspn</refname>
     <refpurpose>
- Find length of initial segment matching mask.
+ Find length of initial segment matching mask
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -2151,7 +2157,7 @@
   <refentry id="function.strstr">
    <refnamediv>
     <refname>strstr</refname>
- <refpurpose>Find first occurrence of a string.</refpurpose>
+ <refpurpose>Find first occurrence of a string</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -2177,7 +2183,7 @@
       <programlisting role="php">
 $email = 'sterling <email protected>';
 $domain = strstr ($email, '@');
-print $domain; // prints designmultimedia.com
+print $domain; // prints  <email protected>
       </programlisting>
      </example>
     </para>
@@ -2244,7 +2250,7 @@
   <refentry id="function.strtolower">
    <refnamediv>
     <refname>strtolower</refname>
- <refpurpose>Make a string lowercase.</refpurpose>
+ <refpurpose>Make a string lowercase</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -2281,7 +2287,7 @@
   <refentry id="function.strtoupper">
    <refnamediv>
     <refname>strtoupper</refname>
- <refpurpose>Make a string uppercase.</refpurpose>
+ <refpurpose>Make a string uppercase</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -2319,7 +2325,7 @@
    <refnamediv>
     <refname>str_replace</refname>
     <refpurpose>
- Replace all occurrences of needle in haystack with str.
+ Replace all occurrences of needle in haystack with str
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -2365,7 +2371,7 @@
   <refentry id="function.strtr">
    <refnamediv>
     <refname>strtr</refname>
- <refpurpose>Translate certain characters.</refpurpose>
+ <refpurpose>Translate certain characters</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -2508,7 +2514,7 @@
   <refentry id="function.substr-replace">
    <refnamediv>
     <refname>substr_replace</refname>
- <refpurpose>Replace text within a portion of a string.</refpurpose>
+ <refpurpose>Replace text within a portion of a string</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -2591,7 +2597,7 @@
    <refnamediv>
     <refname>trim</refname>
     <refpurpose>
- Strip whitespace from the beginning and end of a string.
+ Strip whitespace from the beginning and end of a string
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -2618,9 +2624,7 @@
   <refentry id="function.ucfirst">
    <refnamediv>
     <refname>ucfirst</refname>
- <refpurpose>
- Make a string's first character uppercase.
- </refpurpose>
+ <refpurpose>Make a string's first character uppercase</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -2638,13 +2642,14 @@
      Note that 'alphabetic' is determined by the current locale. For
      instance, in the default "C" locale characters such as umlaut-a
      (ä) will not be converted.
- <example>
- <title><function>ucfirst</function> example</title>
- <programlisting role="php">
+ <example>
+ <title><function>Ucfirst</function> example</title>
+ <programlisting role="php">
 $text = 'mary had a little lamb and she loved it so.';
-$text = ucfirst($text); // $text is now Mary had a little lamb and she loved it so.
- </programlisting>
- </example>
+$text = ucfirst ($text); // $text is now Mary had a little lamb
+ // and she loved it so.
+ </programlisting>
+ </example>
     </para>
     <para>
      See also <function>strtoupper</function> and
@@ -2671,13 +2676,14 @@
     <para>
      Capitalizes the first character of each word in
      <parameter>str</parameter> if that character is alphabetic.
- <example>
- <title><function>ucwords</function> example</title>
- <programlisting role="php">
+ <example>
+ <title><function>ucwords</function> example</title>
+ <programlisting role="php">
 $text = "mary had a little lamb and she loved it so.";
-$text = ucwords($text); // $text is now: Mary Had A Little Lamb And She Loved It So.
- </programlisting>
- </example>
+$text = ucwords($text); // $text is now: Mary Had A Little
+ // Lamb And She Loved It So.
+ </programlisting>
+ </example>
     </para>
     <para>
      See also <function>strtoupper</function>,