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>.
