Fix grammar in predefined (#5755)

Author: kamil-tekiela

language/predefined/arrayaccess.xml

@@ -9,9 +9,9 @@
 
  <sectionxml:id="arrayaccess.intro">
 &reftitle.intro;
- <para>
- Interface to provide accessing objects as arrays.
- </para>
+ <simpara>
+ Interface to provide access to objects as arrays.
+ </simpara>
  </section>
 
  <sectionxml:id="arrayaccess.synopsis">

language/predefined/iterator.xml

@@ -36,10 +36,10 @@
 
  <sectionxml:id="iterator.iterators">
  <title>Predefined iterators</title>
- <para>
- PHP already provides a number of iterators for many day to day tasks.
+ <simpara>
+ PHP already provides a number of iterators for many day-to-day tasks.
  See <linklinkend="spl.iterators">SPL iterators</link> for a list.
- </para>
+ </simpara>
  </section>
 
  <sectionxml:id="iterator.examples">

language/predefined/serializable.xml

@@ -13,16 +13,20 @@
  Interface for customized serializing.
  </para>
 
- <para>
+ <simpara>
  Classes that implement this interface no longer support
  <linklinkend="object.sleep">__sleep()</link> and
- <linklinkend="object.wakeup">__wakeup()</link>. The method serialize is
- called whenever an instance needs to be serialized. This does not invoke __destruct()
- or have any other side effect unless programmed inside the method. When the data is
- unserialized the class is known and the appropriate unserialize() method is called as
- a constructor instead of calling __construct(). If you need to execute the standard
- constructor you may do so in the method.
- </para>
+ <linklinkend="object.wakeup">__wakeup()</link>.
+ The <methodname>serialize</methodname> method is
+ called whenever an instance needs to be serialized.
+ This does not invoke <methodname>__destruct</methodname>
+ or have any other side effect unless programmed inside the method.
+ When the data is unserialized the class is known and the appropriate
+ <methodname>unserialize</methodname> method is called as
+ a constructor instead of calling <methodname>__construct</methodname>.
+ The constructor can be called from within the
+ <methodname>unserialize</methodname> method if desired.
+ </simpara>
 
  <warning>
  <para>

language/predefined/stdclass.xml

@@ -13,14 +13,14 @@
  A generic empty class with dynamic properties.
  </para>
 
- <para>
- Objects of this class can be instantiated with
+ <simpara>
+ Objects of this class can be instantiated with the
  <linklinkend="language.oop5.basic.new">new</link> operator or created by
  <linklinkend="language.types.object.casting">typecasting to object</link>.
  Several PHP functions also create instances of this class, e.g.
  <function>json_decode</function>, <function>mysqli_fetch_object</function>
  or <methodname>PDOStatement::fetchObject</methodname>.
- </para>
+ </simpara>
 
  <para>
  Despite not implementing
@@ -29,12 +29,12 @@
  <code>#[\AllowDynamicProperties]</code> attribute.
  </para>
 
- <para>
+ <simpara>
  This is not a base class as PHP does not have a concept of a universal base
- class. However, it is possible to create a custom class that extends from
+ class. However, it is possible to create a custom class that extends
  <classname>stdClass</classname> and as a result inherits the functionality
  of dynamic properties.
- </para>
+ </simpara>
  </section>
 
  <sectionxml:id="stdclass.synopsis">

language/predefined/traversable.xml

@@ -29,7 +29,7 @@
  </classsynopsis>
 
  <simpara>
- This interface has no methods, its only purpose is to be the base
+ This interface has no methods; its only purpose is to be the base
  interface for all traversable classes.
  </simpara>
 

language/predefined/valueerror.xml

@@ -8,13 +8,13 @@
 
  <sectionxml:id="valueerror.intro">
 &reftitle.intro;
- <para>
+ <simpara>
  A <classname>ValueError</classname> is thrown when the
- type of an argument is correct but the value of it is incorrect.
+ type of an argument is correct but its value is incorrect.
  For example, passing a negative integer when the function expects a
  positive one, or passing an empty string/array when the function expects
  it to not be empty.
-</para>
+ </simpara>
  </section>
 
  <sectionxml:id="valueerror.synopsis">

language/predefined/weakmap.xml

@@ -9,14 +9,14 @@
 
  <sectionxml:id="weakmap.intro">
 &reftitle.intro;
- <para>
- A <classname>WeakMap</classname> is map (or dictionary) that accepts objects as keys. However, unlike the
- otherwise similar <classname>SplObjectStorage</classname>, an object in a key of <classname>WeakMap</classname>
+ <simpara>
+ A <classname>WeakMap</classname> is a map (or dictionary) that accepts objects as keys. However, unlike the
+ otherwise similar <classname>SplObjectStorage</classname>, an object in a key of a <classname>WeakMap</classname>
  does not contribute toward the object's reference count. That is, if at any point the only remaining reference
  to an object is the key of a <classname>WeakMap</classname>, the object will be garbage collected and removed
  from the <classname>WeakMap</classname>. Its primary use case is for building caches of data derived from
  an object that do not need to live longer than the object.
- </para>
+ </simpara>
  <para>
  <classname>WeakMap</classname> implements <interfacename>ArrayAccess</interfacename>,
  <interfacename>Traversable</interfacename> (via <interfacename>IteratorAggregate</interfacename>),
@@ -56,7 +56,7 @@
 &reftitle.examples;
  <para>
  <example>
- <title><classname>Weakmap</classname> usage example</title>
+ <title><classname>WeakMap</classname> usage example</title>
  <programlistingrole="php">
 <![CDATA[
 <?php

language/predefined/weakreference.xml

@@ -9,15 +9,16 @@
 
  <sectionxml:id="weakreference.intro">
 &reftitle.intro;
- <para>
- Weak references allow the programmer to retain a reference to an object which does not prevent
- the object from being destroyed. They are useful for implementing cache like structures.
+ <simpara>
+ Weak references allow the programmer to retain a reference to an object
+ without preventing the object from being destroyed.
+ They are useful for implementing cache-like structures.
  If the original object has been destroyed, &null; will be returned
  when calling the <methodname>WeakReference::get</methodname> method.
  The original object will be destroyed when the
  <linklinkend="features.gc.refcounting-basics">refcount</link> for it drops to zero;
  creating weak references does not increase the <literal>refcount</literal> of the object being referenced.
- </para>
+ </simpara>
  <simpara>
  <classname>WeakReference</classname>s cannot be serialized.
  </simpara>