doc: comma placement corrections and word order

Set commas where there should be some.
Some improvements to word order.

1 files changed, 11 insertions, 11 deletions

diff --git a/man/sd_bus_message_append_array.xml b/man/sd_bus_message_append_array.xml
index fe84671f3e..455e1bb3af 100644
--- a/man/sd_bus_message_append_array.xml
+++ b/man/sd_bus_message_append_array.xml
@@ -91,7 +91,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
   <refsect1>
     <title>Description</title>
 
-    <para>Function <function>sd_bus_message_append_array</function>
+    <para>The <function>sd_bus_message_append_array</function> functionc
     appends items to message <parameter>m</parameter> as the single
     array. A container will be opened, items appended, and the
     container closed. Parameter <parameter>type</parameter> determines
@@ -116,19 +116,19 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
     into the memory area containing the message and may be changed
     after this call.</para>
 
-    <para>Function
-    <function>sd_bus_message_append_array_memfd</function> appends
+    <para>The
+    <function>sd_bus_message_append_array_memfd</function> function appends
     items to message <parameter>m</parameter>, similarly to
     <function>sd_bus_message_append_array</function>. Contents of the
     memory file descriptor <parameter>memfd</parameter> are used as
     the contents of the array. Their size must be a multiple of the
     size of the type <parameter>type</parameter>.</para>
 
-    <para>Descriptor <parameter>memfd</parameter> will be sealed
-    and cannot be modified after this call.</para>
+    <para>The descriptor specified with <parameter>memfd</parameter>
+    will be sealed and cannot be modified after this call.</para>
 
-    <para>Function
-    <function>sd_bus_message_append_array_iovec</function> appends
+    <para>The
+    <function>sd_bus_message_append_array_iovec</function> function appends
     items to message <parameter>m</parameter>, similarly to
     <function>sd_bus_message_append_array</function>. Contents of the
     iovec <parameter>iov</parameter> are used as the contents of the
@@ -136,7 +136,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
     sum of <structfield>iov_len</structfield> fields) must be a multiple
     of the size of the type <parameter>type</parameter>.</para>
 
-    <para>Pointer <parameter>iov</parameter> must point to
+    <para>The <parameter>iov</parameter> argument must point to
     <parameter>n</parameter> <structname>struct iovec</structname>
     structures. Each structure may have the
     <structname>iov_base</structname> field set, in which case the
@@ -146,8 +146,8 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
     memory pointed at by <parameter>iov</parameter> may be changed
     after this call.</para>
 
-    <para>Function
-    <function>sd_bus_message_append_array_space</function> appends
+    <para>The
+    <function>sd_bus_message_append_array_space</function> function appends
     space for an array of items to message <parameter>m</parameter>.
     It behaves the same as
     <function>sd_bus_message_append_array</function>, but instead
@@ -159,7 +159,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
   <refsect1>
     <title>Return Value</title>
 
-    <para>On success, those calls return 0 or a positive integer. On
+    <para>On success, these calls return 0 or a positive integer. On
     failure, they returns a negative errno-style error code.</para>
   </refsect1>