From b1879b7899cd7e1e27179ce014aec058cf5154d2 Mon Sep 17 00:00:00 2001
From: Daniel Mack <daniel@zonque.org>
Date: Wed, 28 Jan 2015 17:37:10 +0100
Subject: [PATCH] doc: more return value section cleanups

Signed-off-by: Daniel Mack <daniel@zonque.org>
---
 doc/kdbus.bus.xml        |  5 +++--
 doc/kdbus.connection.xml |  5 +++--
 doc/kdbus.endpoint.xml   |  5 +++--
 doc/kdbus.match.xml      |  5 +++--
 doc/kdbus.message.xml    |  5 +++--
 doc/kdbus.names.xml      |  5 +++--
 doc/kdbus.pool.xml       | 11 +++++------
 7 files changed, 23 insertions(+), 18 deletions(-)

diff --git a/doc/kdbus.bus.xml b/doc/kdbus.bus.xml
index 52ae9f2..b2248e8 100644
--- a/doc/kdbus.bus.xml
+++ b/doc/kdbus.bus.xml
@@ -210,8 +210,9 @@ struct kdbus_cmd_make {
   <refsect1>
     <title>Return value</title>
     <para>
-      On success, all metioned ioctl commands return 0; on error, -1 is
-      returned, and errno is set to indicate the error.
+      On success, all metioned ioctl commands return <errorcode>0</errorcode>;
+      on error, <errorcode>-1</errorcode> is returned, and
+      <varname>errno</varname> is set to indicate the error.
     </para>
 
     <refsect2>
diff --git a/doc/kdbus.connection.xml b/doc/kdbus.connection.xml
index 41d20ec..10f5ed9 100644
--- a/doc/kdbus.connection.xml
+++ b/doc/kdbus.connection.xml
@@ -816,8 +816,9 @@ struct kdbus_cmd_update {
   <refsect1>
     <title>Return value</title>
     <para>
-      On success, all metioned ioctl commands return 0; on error, -1 is
-      returned, and errno is set to indicate the error.
+      On success, all metioned ioctl commands return <errorcode>0</errorcode>;
+      on error, <errorcode>-1</errorcode> is returned, and
+      <varname>errno</varname> is set to indicate the error.
     </para>
 
     <refsect2>
diff --git a/doc/kdbus.endpoint.xml b/doc/kdbus.endpoint.xml
index 78caf38..b2bf61d 100644
--- a/doc/kdbus.endpoint.xml
+++ b/doc/kdbus.endpoint.xml
@@ -256,8 +256,9 @@ struct kdbus_cmd_make {
   <refsect1>
     <title>Return value</title>
     <para>
-      On success, all metioned ioctl commands return 0; on error, -1 is
-      returned, and errno is set to indicate the error.
+      On success, all metioned ioctl commands return <errorcode>0</errorcode>;
+      on error, <errorcode>-1</errorcode> is returned, and
+      <varname>errno</varname> is set to indicate the error.
     </para>
 
     <refsect2>
diff --git a/doc/kdbus.match.xml b/doc/kdbus.match.xml
index cc4c160..90273a4 100644
--- a/doc/kdbus.match.xml
+++ b/doc/kdbus.match.xml
@@ -397,8 +397,9 @@ struct kdbus_cmd_match {
   <refsect1>
     <title>Return value</title>
     <para>
-      On success, all metioned ioctl commands return 0; on error, -1 is
-      returned, and errno is set to indicate the error.
+      On success, all metioned ioctl commands return <errorcode>0</errorcode>;
+      on error, <errorcode>-1</errorcode> is returned, and
+      <varname>errno</varname> is set to indicate the error.
     </para>
 
     <refsect2>
diff --git a/doc/kdbus.message.xml b/doc/kdbus.message.xml
index 61b3355..c4a983f 100644
--- a/doc/kdbus.message.xml
+++ b/doc/kdbus.message.xml
@@ -763,8 +763,9 @@ struct kdbus_msg_info {
   <refsect1>
     <title>Return value</title>
     <para>
-      On success, all metioned ioctl commands return 0; on error, -1 is
-      returned, and errno is set to indicate the error.
+      On success, all metioned ioctl commands return <errorcode>0</errorcode>;
+      on error, <errorcode>-1</errorcode> is returned, and
+      <varname>errno</varname> is set to indicate the error.
     </para>
 
     <refsect2>
diff --git a/doc/kdbus.names.xml b/doc/kdbus.names.xml
index 816b337..aa8e346 100644
--- a/doc/kdbus.names.xml
+++ b/doc/kdbus.names.xml
@@ -476,8 +476,9 @@ struct kdbus_name_info {
   <refsect1>
     <title>Return value</title>
     <para>
-      On success, all metioned ioctl commands return 0; on error, -1 is
-      returned, and errno is set to indicate the error.
+      On success, all metioned ioctl commands return <errorcode>0</errorcode>;
+      on error, <errorcode>-1</errorcode> is returned, and
+      <varname>errno</varname> is set to indicate the error.
     </para>
 
     <refsect2>
diff --git a/doc/kdbus.pool.xml b/doc/kdbus.pool.xml
index db9d3c3..173c60d 100644
--- a/doc/kdbus.pool.xml
+++ b/doc/kdbus.pool.xml
@@ -110,10 +110,8 @@ buf = mmap(NULL, POOL_SIZE, PROT_READ, MAP_SHARED, conn_fd, 0);
 
     <para>
       When access to the pool memory is no longer needed, userspace should
-      call
-      <citerefentry><refentrytitle>munmap</refentrytitle><manvolnum>2</manvolnum></citerefentry>
-      on the pointer returned by
-      <citerefentry><refentrytitle>mmap</refentrytitle><manvolnum>2</manvolnum></citerefentry>.
+      call <function>munmap</function> on the pointer returned by
+      <function>mmap</function>.
     </para>
   </refsect1>
 
@@ -198,8 +196,9 @@ struct kdbus_cmd_free {
   <refsect1>
     <title>Return value</title>
     <para>
-      On success, all metioned ioctl commands return 0; on error, -1 is
-      returned, and errno is set to indicate the error.
+      On success, all metioned ioctl commands return <errorcode>0</errorcode>;
+      on error, <errorcode>-1</errorcode> is returned, and
+      <varname>errno</varname> is set to indicate the error.
     </para>
 
     <refsect2>
-- 
2.34.1