grammar (not finished)

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

reference/soap/functions/soap-soapclient-call.xml

@@ -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">

reference/soap/functions/soap-soapclient-construct.xml

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

reference/soap/ini.xml

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

reference/soap/reference.xml

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