[PHP-DOC] cvs: phpdoc /en/functions com.xml From: James Moore (James <email protected>)
Date: 08/30/00

jmoore Wed Aug 30 04:05:56 2000 EDT

  Modified files:
    /phpdoc/en/functions com.xml
  Log:
  Begining of some COM documentation.
  
Index: phpdoc/en/functions/com.xml
diff -u phpdoc/en/functions/com.xml:1.3 phpdoc/en/functions/com.xml:1.4
--- phpdoc/en/functions/com.xml:1.3 Sat Jun 24 00:38:43 2000
+++ phpdoc/en/functions/com.xml Wed Aug 30 04:05:55 2000
@@ -12,7 +12,9 @@
   <refentry id="function.com-load">
    <refnamediv>
     <refname>com_load</refname>
- <refpurpose>???</refpurpose>
+ <refpurpose>
+ Creates a new reference to a COM component.
+ </refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
@@ -28,6 +30,9 @@
      </funcprototype>
     </funcsynopsis>
     <para>
+ <function>com_load</function> creates a new COM component and
+ returns a reference to it. Returns <literal>false</literal> on
+ failiure.
     </para>
    </refsect1>
   </refentry>
@@ -35,14 +40,16 @@
   <refentry id="function.com-invoke">
    <refnamediv>
     <refname>com_invoke</refname>
- <refpurpose>???</refpurpose>
+ <refpurpose>
+ Calls a COM component's method.
+ </refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
     <funcsynopsis>
      <funcprototype>
       <funcdef>mixed <function>com_invoke</function></funcdef>
- <paramdef>resource <parameter>object</parameter></paramdef>
+ <paramdef>resource <parameter>com_object</parameter></paramdef>
       <paramdef>string <parameter>function_name</parameter></paramdef>
       <paramdef>mixed
        <parameter>
@@ -52,6 +59,10 @@
      </funcprototype>
     </funcsynopsis>
     <para>
+ <function>com_invoke</function> invokes a method of the COM component
+ referenced by <parameter>com_object</parameter>. Returns <literal>false</literal>
+ on error, returns the <parameter>function_name</parameter>'s return value on
+ success.
     </para>
    </refsect1>
   </refentry>
@@ -59,18 +70,21 @@
   <refentry id="function.com-propget">
    <refnamediv>
     <refname>com_propget</refname>
- <refpurpose>???</refpurpose>
+ <refpurpose>
+ Gets the value of a COM Component's property.
+ </refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
     <funcsynopsis>
      <funcprototype>
       <funcdef>mixed <function>com_propget</function></funcdef>
- <paramdef>resource <parameter>object</parameter></paramdef>
+ <paramdef>resource <parameter>com_object</parameter></paramdef>
       <paramdef>string <parameter>property</parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
+ This function is an alias for <function>com_get</function>.
     </para>
    </refsect1>
   </refentry>
@@ -78,18 +92,23 @@
   <refentry id="function.com-get">
    <refnamediv>
     <refname>com_get</refname>
- <refpurpose>???</refpurpose>
+ <refpurpose>
+ Gets the value of a COM Component's property.
+ </refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
     <funcsynopsis>
      <funcprototype>
       <funcdef>mixed <function>com_get</function></funcdef>
- <paramdef>resource <parameter>object</parameter></paramdef>
+ <paramdef>resource <parameter>com_object</parameter></paramdef>
       <paramdef>string <parameter>property</parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
+ Returns the value of the <parameter>property</parameter> of the
+ COM component referenced by <parameter>com_object</parameter>.
+ Returns <literal>false</literal> on error.
     </para>
    </refsect1>
   </refentry>
@@ -97,19 +116,22 @@
   <refentry id="function.com-propput">
    <refnamediv>
     <refname>com_propput</refname>
- <refpurpose>???</refpurpose>
+ <refpurpose>
+ Assigns a value to a COM component's property.
+ </refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
     <funcsynopsis>
      <funcprototype>
       <funcdef>void <function>com_propput</function></funcdef>
- <paramdef>resource <parameter>object</parameter></paramdef>
+ <paramdef>resource <parameter>com_object</parameter></paramdef>
       <paramdef>string <parameter>property</parameter></paramdef>
       <paramdef>mixed <parameter>value</parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
+ This function is an alias for <function>com_set</function>.
     </para>
    </refsect1>
   </refentry>
@@ -117,20 +139,22 @@
   <refentry id="function.com-propset">
    <refnamediv>
     <refname>com_propset</refname>
- <refpurpose>???</refpurpose>
+ <refpurpose>
+ Assigns a value to a COM component's property.
+ </refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
     <funcsynopsis>
      <funcprototype>
       <funcdef>void <function>com_propset</function></funcdef>
- <paramdef>resource <parameter>object</parameter></paramdef>
+ <paramdef>resource <parameter>com_object</parameter></paramdef>
       <paramdef>string <parameter>property</parameter></paramdef>
       <paramdef>mixed <parameter>value</parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
- This function is an alias for <function>com_propput</function>.
+ This function is an alias for <function>com_set</function>.
     </para>
    </refsect1>
   </refentry>
@@ -138,24 +162,28 @@
   <refentry id="function.com-set">
    <refnamediv>
     <refname>com_set</refname>
- <refpurpose>???</refpurpose>
+ <refpurpose>
+ Assigns a value to a COM component's property.
+ </refpurpose>
    </refnamediv>
    <refsect1>
     <title>Description</title>
     <funcsynopsis>
      <funcprototype>
       <funcdef>void <function>com_set</function></funcdef>
- <paramdef>resource <parameter>object</parameter></paramdef>
+ <paramdef>resource <parameter>com_object</parameter></paramdef>
       <paramdef>string <parameter>property</parameter></paramdef>
       <paramdef>mixed <parameter>value</parameter></paramdef>
      </funcprototype>
     </funcsynopsis>
     <para>
- This function is an alias for <function>com_set</function>.
+ Sets the value of the <parameter>property</parameter> of the
+ COM component referenced by <parameter>com_object</parameter>.
+ Returns <literal>true</literal> if <parameter>property</parameter>
+ is set. Returns <literal>false</literal> on error.
     </para>
    </refsect1>
   </refentry>
-
  </reference>
 
 <!-- Keep this comment at the end of the file