mdoc(7) police:

- lowercase Nd argument
- mark function arguments with Fa
- mark defined values with Dv
- simply copying POSIX text for RETURN VALUES and ERRORS sections is not
  always a good idea.  POSIX uses the word "shall" indicating the behavior
  the correct implementation should follow.

1 files changed, 9 insertions, 19 deletions

diff --git a/lib/libc/posix1e/acl_delete_entry.3 b/lib/libc/posix1e/acl_delete_entry.3
index 256498c..453f72d 100644
--- a/lib/libc/posix1e/acl_delete_entry.3
+++ b/lib/libc/posix1e/acl_delete_entry.3
@@ -30,7 +30,7 @@
 .Os
 .Sh NAME
 .Nm acl_delete_entry
-.Nd Delete an ACL entry from an ACL
+.Nd delete an ACL entry from an ACL
 .Sh LIBRARY
 .Lb libposix1e
 .Sh SYNOPSIS
@@ -41,33 +41,23 @@
 .Sh DESCRIPTION
 .Fn acl_delete_entry
 is a POSIX.1e call that removes the ACL entry
-.Ar entry_d
+.Fa entry_d
 from ACL
-.Ar acl .
+.Fa acl .
 .Sh RETURN VALUES
-Upon successful completion, the function shall return a value of
-.Va 0 .
-Otherwise, a value of
-.Va -1
-shall be returned, and
-.Va errno
-shall be set to indicate the error.
+.Rv -std acl_delete_entry
 .Sh ERRORS
-If the following condition occurs, the
+The
 .Fn acl_delete_entry
-function shall return a value of
-.Va -1
-and set
-.Va errno
-to the corresponding value:
+function fails if:
 .Bl -tag -width Er
 .It Bq Er EINVAL
 Argument
-.Ar acl
+.Fa acl
 does not point to a valid ACL.  Argument
-.Ar entry_d
+.Fa entry_d
 is not a valid descriptor for an ACL entry in
-.Ar acl .
+.Fa acl .
 .El
 .Sh SEE ALSO
 .Xr acl 3 ,