Simplify refpurposes

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

reference/com/functions/variant-set-type.xml

@@ -1,11 +1,11 @@
 <?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.variant-set-type">
    <refnamediv>
     <refname>variant_set_type</refname>
     <refpurpose>
-     Convert a variant into another type. Variant is modified "in-place"
+     Convert a variant into another type "in-place"
     </refpurpose>
    </refnamediv>
    <refsect1>

reference/mailparse/functions/mailparse-msg-extract-part.xml

@@ -1,12 +1,11 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
 <!-- splitted from ./en/functions/mailparse.xml, last change in rev 1.1 -->
   <refentry id="function.mailparse-msg-extract-part">
    <refnamediv>
     <refname>mailparse_msg_extract_part</refname>
     <refpurpose>
-     Extracts/decodes a message section.  If callbackfunc is not
-     specified, the contents will be sent to "stdout"
+     Extracts/decodes a message section
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -21,6 +20,9 @@
     <para>
      &warn.undocumented.func;
     </para>
+    <para>
+     If callbackfunc is not specified, the contents will be sent to "stdout".
+    </para>
    </refsect1>
   </refentry>
 

reference/mailparse/functions/mailparse-uudecode-all.xml

@@ -1,12 +1,11 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.2 $ -->
+<!-- $Revision: 1.3 $ -->
 <!-- splitted from ./en/functions/mailparse.xml, last change in rev 1.1 -->
   <refentry id="function.mailparse-uudecode-all">
    <refnamediv>
     <refname>mailparse_uudecode_all</refname>
     <refpurpose>
-     Scans the data from fp and extract each embedded uuencoded
-     file. Returns an array listing filename information 
+     Scans the data from fp and extract each embedded uuencoded file
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -19,6 +18,9 @@
     <para>
      &warn.undocumented.func;
     </para>
+    <para>
+     Returns an array listing filename information.
+    </para>
    </refsect1>
   </refentry>
 

reference/mcve/functions/mcve-preauthcompletion.xml

@@ -1,11 +1,11 @@
 <?xml version='1.0' encoding='iso-8859-1'?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
 <!-- Generated by xml_proto.php v2.0. Found in /scripts directory of phpdoc. -->
   <refentry id="function.mcve-preauthcompletion">
    <refnamediv>
     <refname>mcve_preauthcompletion</refname>
     <refpurpose>
-     Complete a PREAUTHORIZATION... Ready it for settlement
+     Complete a PREAUTHORIZATION, ready it for settlement
     </refpurpose>
    </refnamediv>
    <refsect1>

reference/ncurses/functions/ncurses-panel-above.xml

@@ -1,11 +1,11 @@
 <?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.ncurses-panel-above">
    <refnamediv>
     <refname>ncurses_panel_above</refname>
     <refpurpose>
-     Returns the panel above panel. If panel is null, returns the bottom panel in the stack
+     Returns the panel above panel
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -17,6 +17,9 @@
     <para>
      &warn.undocumented.func;
     </para>
+    <para>
+     If panel is null, returns the bottom panel in the stack.
+    </para> 
    </refsect1>
   </refentry>
 

reference/ncurses/functions/ncurses-panel-below.xml

@@ -1,11 +1,11 @@
 <?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.ncurses-panel-below">
    <refnamediv>
     <refname>ncurses_panel_below</refname>
     <refpurpose>
-     Returns the panel below panel. If panel is null, returns the top panel in the stack
+     Returns the panel below panel
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -17,6 +17,9 @@
     <para>
      &warn.undocumented.func;
     </para>
+    <para>
+     If panel is null, returns the top panel in the stack.
+    </para>
    </refsect1>
   </refentry>
 

reference/oci8/functions/ocicollmax.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.9 $ -->
+<!-- $Revision: 1.10 $ -->
 <!--
 
 DO NOT TRANSLATE THIS FILE.
@@ -11,10 +11,7 @@ PLEASE, TRANSLATE THE APPROPRIATE NEW FILE.
   <refentry id="function.ocicollmax">
    <refnamediv>
     <refname>ocicollmax</refname>
-    <refpurpose>
-     Return the max value of a collection.  
-     For a varray this is the maximum length of the array
-    </refpurpose>
+    <refpurpose>Gets the maximum number of elements in the collection</refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>

reference/sqlite/functions/sqlite-popen.xml

@@ -1,11 +1,10 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.7 $ -->
+<!-- $Revision: 1.8 $ -->
 <refentry id="function.sqlite-popen">
  <refnamediv>
   <refname>sqlite_popen</refname>
   <refpurpose>
-   Opens a persistent handle to an SQLite database.  Will create the
-   database if it does not exist
+   Opens a persistent handle to an SQLite database and create the database if it does not exist
   </refpurpose>
  </refnamediv>
  <refsect1>

reference/tidy/functions/tidy-save-config.xml

@@ -1,10 +1,10 @@
 <?xml version='1.0' encoding='iso-8859-1'?>
-<!-- $Revision: 1.4 $ -->
+<!-- $Revision: 1.5 $ -->
   <refentry id="function.tidy-save-config">
    <refnamediv>
     <refname>tidy_save_config</refname>
     <refpurpose>
-     Save current settings to named file. Only non-default values are written.
+     Save current settings to named file
     </refpurpose>
    </refnamediv>
    <refsect1>

reference/uodbc/functions/odbc-columns.xml

@@ -1,12 +1,11 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.5 $ -->
+<!-- $Revision: 1.6 $ -->
 <!-- splitted from ./en/functions/uodbc.xml, last change in rev 1.3 -->
   <refentry id="function.odbc-columns">
    <refnamediv>
     <refname>odbc_columns</refname>
     <refpurpose>
-     Lists the column names in specified tables. Returns a result
-     identifier containing the information.
+     Lists the column names in specified tables
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -21,7 +20,7 @@
      </methodsynopsis>
     <para>
      Lists all columns in the requested range.  Returns an ODBC result
-     identifier or &false; on failure.
+     identifier containing the information or &false; on failure.
     </para>
     <para>
      The result set has the following columns:

reference/uodbc/functions/odbc-procedures.xml

@@ -1,12 +1,11 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
 <!-- splitted from ./en/functions/uodbc.xml, last change in rev 1.3 -->
   <refentry id="function.odbc-procedures">
    <refnamediv>
     <refname>odbc_procedures</refname>
     <refpurpose>
-     Get the list of procedures stored in a specific data source.
-     Returns a result identifier containing the information.
+     Get the list of procedures stored in a specific data source
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -20,7 +19,7 @@
      </methodsynopsis>
     <para> 
      Lists all procedures in the requested range.  Returns an ODBC
-     result identifier or &false; on failure.
+     result identifier containing the information or &false; on failure.
     </para>
     <para>
      The result set has the following columns:

reference/uodbc/functions/odbc-tables.xml

@@ -1,13 +1,11 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
 <!-- splitted from ./en/functions/uodbc.xml, last change in rev 1.3 -->
   <refentry id="function.odbc-tables">
    <refnamediv>
     <refname>odbc_tables</refname>
     <refpurpose>
-     Get the list of table names stored in a specific data source.
-     Returns a result identifier containing the
-     information.
+     Get the list of table names stored in a specific data source
     </refpurpose>
    </refnamediv>
    <refsect1>
@@ -22,7 +20,7 @@
      </methodsynopsis>
     <para>
      Lists all tables in the requested range.  Returns an ODBC result
-     identifier or &false; on failure.
+     identifier containing the information or &false; on failure.
     </para>
     <para>
      The result set has the following columns: