cvs: phpdoc /en/reference/soap ini.xml reference.xml /en/reference/soap/functions soap-soapclient-call.xml soap-soapclient-construct.xml

sean Sun Jan 16 00:28:55 2005 EDT Modified files: /phpdoc/en/reference/soap ini.xml reference.xml /phpdoc/en/reference/soap/functions soap-soapclient-call.xml soap-soapclient-construct.xml Log: grammar (not finished) http://cvs.php.net/diff.php/phpdoc/en/reference/soap/ini.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc/en/reference/soap/ini.xml diff -u phpdoc/en/reference/soap/ini.xml:1.3 phpdoc/en/reference/soap/ini.xml:1.4 --- phpdoc/en/reference/soap/ini.xml:1.3 Wed Jul 7 06:03:22 2004 +++ phpdoc/en/reference/soap/ini.xml Sun Jan 16 00:28:55 2005 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <section id="soap.configuration"> &reftitle.runtime; &extension.runtime; @@ -48,7 +48,7 @@ </term> <listitem> <para> - Enables or disables WSDL caching feature. + Enables or disables the WSDL caching feature. </para> </listitem> </varlistentry> @@ -59,7 +59,7 @@ </term> <listitem> <para> - Sets the directory name where SOAP extension will put cache files. + Sets the directory name where the SOAP extension will put cache files. </para> </listitem> </varlistentry> @@ -70,8 +70,8 @@ </term> <listitem> <para> - (time to live) Sets the number of second while cached file will be used - instead of original one. + Sets the number of seconds (time to live) that cached files will be used + instead the originals. </para> </listitem> </varlistentry> http://cvs.php.net/diff.php/phpdoc/en/reference/soap/reference.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc/en/reference/soap/reference.xml diff -u phpdoc/en/reference/soap/reference.xml:1.4 phpdoc/en/reference/soap/reference.xml:1.5 --- phpdoc/en/reference/soap/reference.xml:1.4 Sun Jan 9 22:02:33 2005 +++ phpdoc/en/reference/soap/reference.xml Sun Jan 16 00:28:55 2005 @@ -1,5 +1,5 @@ <?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. --> <reference id="ref.soap"> <title>SOAP Functions</title> @@ -47,7 +47,8 @@ &reftitle.constructor; <itemizedlist> <listitem> - <para><xref linkend='function.soap-soapclient-construct' /> - construct a new SoapClient object</para> + <para><xref linkend='function.soap-soapclient-construct' /> - + constructs a new SoapClient object</para> </listitem> </itemizedlist> </section> http://cvs.php.net/diff.php/phpdoc/en/reference/soap/functions/soap-soapclient-call.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc/en/reference/soap/functions/soap-soapclient-call.xml diff -u phpdoc/en/reference/soap/functions/soap-soapclient-call.xml:1.1 phpdoc/en/reference/soap/functions/soap-soapclient-call.xml:1.2 --- phpdoc/en/reference/soap/functions/soap-soapclient-call.xml:1.1 Sun Jan 9 19:46:17 2005 +++ phpdoc/en/reference/soap/functions/soap-soapclient-call.xml Sun Jan 16 00:28:55 2005 @@ -1,5 +1,5 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <refentry id="function.soap-soapclient-call"> <refnamediv> <refname>SoapClient->__call()</refname> @@ -22,25 +22,28 @@ </methodsynopsis> </classsynopsis> <para> - This is a low level API function to make a SOAP call. Usually in WSDL mode + This is a low level API function that is used to make a SOAP call. Usually, + in WSDL mode, you can simply call SOAP functions as <classname>SoapClient</classname> - methods. It is useful for non-WSDL mode when <literal>soapaction</literal> - is unknown, <literal>uri</literal> differs from the default or when you like - to send and/or receive SOAP Headers. + methods. This method useful in non-WSDL mode when <literal>soapaction</literal> + is unknown, <literal>uri</literal> differs from the default or when sending + and/or receiving SOAP Headers. </para> <para> - On error, a call to a SOAP function can cause PHP exceptions or return a - <classname>SoapFault</classname> object if exceptions was disabled. - To check if the function call failed catch the SoapFault exceptions or + On error, a call to a SOAP function can cause PHP to throw exceptions or return a + <classname>SoapFault</classname> object if exceptions are disabled. + To check if the function call failed to catch the SoapFault exceptions, check the result with <function>is_soap_fault</function>. </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - SOAP functions may return one or several values. In the first case it will - return just the value of output parameter, in the second it will return - the associative array with named output parameters. + SOAP functions may return one, or multiple values. If only one value is returned + by the SOAP function, the return value of <literal>__call</literal> will be + a simple value (e.g. an integer, a string, etc). If multiple values are + returned, <literal>__call</literal> will return + an associative array of named output parameters. </para> </refsect1> <refsect1 role="examples"> http://cvs.php.net/diff.php/phpdoc/en/reference/soap/functions/soap-soapclient-construct.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc/en/reference/soap/functions/soap-soapclient-construct.xml diff -u phpdoc/en/reference/soap/functions/soap-soapclient-construct.xml:1.1 phpdoc/en/reference/soap/functions/soap-soapclient-construct.xml:1.2 --- phpdoc/en/reference/soap/functions/soap-soapclient-construct.xml:1.1 Sun Jan 9 19:46:17 2005 +++ phpdoc/en/reference/soap/functions/soap-soapclient-construct.xml Sun Jan 16 00:28:55 2005 @@ -1,5 +1,5 @@ <?xml version='1.0' encoding='iso-8859-1'?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <refentry id="function.soap-soapclient-construct"> <refnamediv> <refname>SoapClient->__construct()</refname> @@ -18,7 +18,7 @@ </constructorsynopsis> </classsynopsis> <para> - This constructor allows creating <classname>SoapClient</classname> objects + This constructor creates <classname>SoapClient</classname> objects in <literal>WSDL</literal> or <literal>non-WSDL</literal> mode. </para> </refsect1> @@ -39,15 +39,15 @@ <term><parameter>options</parameter></term> <listitem> <para> - An array of option. If working in WSDL mode, this parameter is optional. + An array of options. If working in WSDL mode, this parameter is optional. If working in non-WSDL mode, you must set the <literal>location</literal> and <literal>uri</literal> options, where <literal>location</literal> is - a URL to request and <literal>uri</literal> is a target namespace of the + the URL to request and <literal>uri</literal> is the target namespace of the SOAP service. </para> <para> The <literal>style</literal> and <literal>use</literal> options only work in - non-WSDL mode. In WSDL mode, they comes from the WSDL file. + non-WSDL mode. In WSDL mode, they come from the WSDL file. </para> <para> The <literal>soap_version</literal> option specifies whether to use SOAP @@ -55,7 +55,7 @@ </para> <para> For HTTP authentication, you may use the <literal>login</literal> and - <literal>password</literal> options. For making a HTTP connection through + <literal>password</literal> options. For making an HTTP connection through a proxy server, use the options <literal>proxy_host</literal>, <literal>proxy_port</literal>, <literal>proxy_login</literal> and <literal>proxy_password</literal>.