From b8bde11658366290521e3d03316378b482600323 Mon Sep 17 00:00:00 2001
From: Jan Engelhardt <jengelh@inai.de>
Date: Thu, 8 May 2014 01:28:45 +0200
Subject: doc: comma placement corrections and word order

Set commas where there should be some.
Some improvements to word order.
---
 man/sd_bus_message_append_array.xml | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

(limited to 'man/sd_bus_message_append_array.xml')

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>
 
-- 
cgit v1.2.1