man page tweaks

Merge of xfs-cmds-lbs:slinx:159636a by lord.

14 files changed, 39 insertions, 39 deletions

diff --git a/man/man3/acl_copy_ext.3 b/man/man3/acl_copy_ext.3
index 8361d51..df563e7 100644
--- a/man/man3/acl_copy_ext.3
+++ b/man/man3/acl_copy_ext.3
@@ -54,13 +54,13 @@ to the ACL referenced by
 .Va acl
 continue to refer to the ACL.
 .Sh RETURN VALUE
-Upon successful completion, this function returns the number of bytes placed in the buffer pointed to by
+Upon success, this function returns the number of bytes placed in the buffer pointed to by
 .Va buf_p .
-Otherwise, a value of
+On error, a value of
 .Li (ssize_t)-1
 is returned and
 .Va errno
-is set to indicate the error.
+is set appropriately.
 .Sh ERRORS
 If any of the following conditions occur, the
 .Fn acl_copy_ext
diff --git a/man/man3/acl_copy_int.3 b/man/man3/acl_copy_int.3
index 0a69105..dcff7e8 100644
--- a/man/man3/acl_copy_int.3
+++ b/man/man3/acl_copy_int.3
@@ -43,15 +43,15 @@ returned by
 .Fn acl_copy_int
 as an argument.
 .Sh RETURN VALUE
-Upon successful completion,
+Upon success,
 the
 .Fn acl_copy_int
 function returns a pointer that references the ACL in working storage.
-Otherwise, a value of
+On error, a value of
 .Li (acl_t)NULL
 is returned, and
 .Va errno
-is set to indicate the error.
+is set appropriately.
 .Sh ERRORS
 If any of the following conditions occur, the
 .Fn acl_copy_int
diff --git a/man/man3/acl_create_entry.3 b/man/man3/acl_create_entry.3
index 7975d6f..cc9d124 100644
--- a/man/man3/acl_create_entry.3
+++ b/man/man3/acl_create_entry.3
@@ -32,7 +32,7 @@ The
 .Fn acl_create_entry
 function creates a new ACL entry in the ACL pointed to by the contents of the pointer argument
 .Va acl_p .
-Upon successful completion, the function returns a descriptor for the new
+On success, the function returns a descriptor for the new
 ACL entry via
 .Va entry_p .
 .Pp
diff --git a/man/man3/acl_dup.3 b/man/man3/acl_dup.3
index 3548acc..913260e 100644
--- a/man/man3/acl_dup.3
+++ b/man/man3/acl_dup.3
@@ -42,12 +42,12 @@ returned by
 .Fn acl_dup
 as an argument.
 .Sh RETURN VALUE
-Upon successful completion, this function returns a pointer to the
-working storage.  Otherwise, a value of
+On success, this function returns a pointer to the
+working storage.  On error, a value of
 .Li (acl_t)NULL
 is returned, and
 .Va errno
-is set to indicate the error.
+is set appropriately.
 .Sh ERRORS
 If any of the following conditions occur, the
 .Fn acl_dup
diff --git a/man/man3/acl_equiv_mode.3 b/man/man3/acl_equiv_mode.3
index 9a2a81f..e0576ff 100644
--- a/man/man3/acl_equiv_mode.3
+++ b/man/man3/acl_equiv_mode.3
@@ -51,7 +51,7 @@ is set to the value that defines the same owner, group and other
 permissions as contained in
 the ACL.
 .Sh RETURN VALUE
-Upon successful completion, this function returns the value
+On success, this function returns the value
 .Li 0
 if
 .Va acl
@@ -59,11 +59,11 @@ is an equivalent ACL, and the value
 .Li 1
 if
 .Va acl
-is not an equivalent ACL. Otherwise, the value
+is not an equivalent ACL. On error, the value
 .Li -1
 is returned, and
 .Va errno
-is set to indicate the error.
+is set appropriately.
 .Sh ERRORS
 If any of the following conditions occur, the
 .Fn acl_equiv_mode
diff --git a/man/man3/acl_from_mode.3 b/man/man3/acl_from_mode.3
index 86d2e43..babd519 100644
--- a/man/man3/acl_from_mode.3
+++ b/man/man3/acl_from_mode.3
@@ -36,12 +36,12 @@ corresponding to the owner, group, and other permission bits of its
 argument
 .Va mode .
 .Sh RETURN VALUE
-Upon successful completion, this function returns a pointer to the
-working storage. Otherwise, a value of
+On success, this function returns a pointer to the
+working storage. On error, a value of
 .Li (acl_t)NULL
 is returned, and
 .Va errno
-is set to indicate the error.
+is set appropriately.
 .Sh ERRORS
 If any of the following conditions occur, the
 .Fn acl_from_mode
diff --git a/man/man3/acl_from_text.3 b/man/man3/acl_from_text.3
index af642a5..794b75e 100644
--- a/man/man3/acl_from_text.3
+++ b/man/man3/acl_from_text.3
@@ -47,12 +47,12 @@ returned by
 .Fn acl_from_text
 as an argument.
 .Sh RETURN VALUE
-Upon successful completion, this function returns a pointer to the
-working storage.  Otherwise, a value of
+On success, this function returns a pointer to the
+working storage.  On error, a value of
 .Li (acl_t)NULL
 is returned, and
 .Va errno
-is set to indicate the error.
+is set appropriately.
 .Sh ERRORS
 If any of the following conditions occur, the
 .Fn acl_from_text
diff --git a/man/man3/acl_get_fd.3 b/man/man3/acl_get_fd.3
index e2cc1c4..8f7e45a 100644
--- a/man/man3/acl_get_fd.3
+++ b/man/man3/acl_get_fd.3
@@ -48,12 +48,12 @@ returned by
 .Fn acl_get_fd
 as an argument.
 .Sh RETURN VALUE
-Upon successful completion, this function shall return a pointer to the
-working storage.  Otherwise, a value of
+On success, this function shall return a pointer to the
+working storage.  On error, a value of
 .Li (acl_t)NULL
 shall be returned, and
 .Va errno
-shall be set to indicate the error.
+is set appropriately.
 .Sh ERRORS
 If any of the following conditions occur, the
 .Fn acl_get_fd
diff --git a/man/man3/acl_get_file.3 b/man/man3/acl_get_file.3
index 10e241d..eaa40c3 100644
--- a/man/man3/acl_get_file.3
+++ b/man/man3/acl_get_file.3
@@ -70,12 +70,12 @@ returned by
 .Fn acl_get_file
 as an argument.
 .Sh RETURN VALUE
-Upon successful completion, this function returns a pointer to the
-working storage.  Otherwise, a value of
+On success, this function returns a pointer to the
+working storage.  On error, a value of
 .Li (acl_t)NULL
 is returned, and
 .Va errno
-is set to indicate the error.
+is set appropriately.
 .Sh ERRORS
 If any of the following conditions occur, the
 .Fn acl_get_file
diff --git a/man/man3/acl_get_qualifier.3 b/man/man3/acl_get_qualifier.3
index 6c4dbad..6bfcc5c 100644
--- a/man/man3/acl_get_qualifier.3
+++ b/man/man3/acl_get_qualifier.3
@@ -74,11 +74,11 @@ entries in the ACL containing the entry referred to by
 .Va entry_d
 remains unchanged.
 .Sh RETURN VALUE
-Upon successful completion, the function returns a pointer to the tag qualifier that was retrieved into ACL working storage. Otherwise, a value of
+On success, the function returns a pointer to the tag qualifier that was retrieved into ACL working storage. On error, a value of
 .Li (void *)NULL
 is returned and
 .Va errno
-is set to indicate the error.
+is set appropriately.
 .Sh ERRORS
 If any of the following conditions occur, the
 .Fn acl_get_qualifier
diff --git a/man/man3/acl_init.3 b/man/man3/acl_init.3
index 0bc5cd3..b5b87c5 100644
--- a/man/man3/acl_init.3
+++ b/man/man3/acl_init.3
@@ -44,12 +44,12 @@ returned by
 .Fn acl_init
 as an argument.
 .Sh RETURN VALUE
-Upon successful completion, this function returns a pointer to the
-working storage.  Otherwise, a value of
+On success, this function returns a pointer to the
+working storage.  On error, a value of
 .Li (acl_t)NULL
 is returned, and
 .Va errno
-is set to indicate the error.
+is set appropriately.
 .Sh ERRORS
 If any of the following conditions occur, the
 .Fn acl_init
diff --git a/man/man3/acl_size.3 b/man/man3/acl_size.3
index a785e3b..9cca15e 100644
--- a/man/man3/acl_size.3
+++ b/man/man3/acl_size.3
@@ -44,14 +44,14 @@ continue to refer to the ACL. The order of ACL entries within
 .Va acl
 remains unchanged.
 .Sh RETURN VALUE
-Upon successful completion, the
+On success, the
 .Fn acl_size
 function returns the size in bytes of the contiguous, persistent form of
-the ACL. Otherwise, a value of
+the ACL. On error, a value of
 .Li (ssize_t)-1
 is returned and
 .Va errno
-is set to indicate the error.
+is set appropriately.
 .Sh ERRORS
 If any of the following conditions occur, the
 .Fn acl_size
diff --git a/man/man3/acl_to_any_text.3 b/man/man3/acl_to_any_text.3
index ef59ba9..ed0e190 100644
--- a/man/man3/acl_to_any_text.3
+++ b/man/man3/acl_to_any_text.3
@@ -122,12 +122,12 @@ returned by
 .Fn acl_to_any_text
 as an argument.
 .Sh RETURN VALUE
-Upon successful completion, this function returns a pointer to the text
-representation of the ACL.  Otherwise, a value of
+On success, this function returns a pointer to the text
+representation of the ACL.  On error, a value of
 .Li (char *)NULL
 is returned, and
 .Va errno
-is set to indicate the error.
+is set appropriately.
 .Sh ERRORS
 If any of the following conditions occur, the
 .Fn acl_to_any_text
diff --git a/man/man3/acl_to_text.3 b/man/man3/acl_to_text.3
index 2a2d261..266edd1 100644
--- a/man/man3/acl_to_text.3
+++ b/man/man3/acl_to_text.3
@@ -61,13 +61,13 @@ returned by
 .Fn acl_to_text
 as an argument.
 .Sh RETURN VALUE
-Upon successful completion, this function returns a pointer to the
+On success, this function returns a pointer to the
 long text form of the ACL.
-Otherwise, a value of
+On error, a value of
 .Li (char *)NULL
 is returned, and
 .Va errno
-is set to indicate the error.
+is set appropriately.
 .Sh ERRORS
 If any of the following conditions occur, the
 .Fn acl_to_text