mdoc(7) police: fix markup.

16 files changed, 144 insertions, 302 deletions

diff --git a/lib/libc/posix1e/acl_add_perm.3 b/lib/libc/posix1e/acl_add_perm.3
index 7354d23..88b22fb 100644
--- a/lib/libc/posix1e/acl_add_perm.3
+++ b/lib/libc/posix1e/acl_add_perm.3
@@ -30,48 +30,38 @@
 .Os
 .Sh NAME
 .Nm acl_add_perm
-.Nd Add permissions to a permission set
+.Nd add permissions to a permission set
 .Sh LIBRARY
 .Lb libposix1e
 .Sh SYNOPSIS
 .Fd #include <sys/types.h>
 .Fd #include <sys/acl.h>
 .Ft int
-.Fn acl_add_perm "acl_permset_t permset_d, acl_perm_t perm"
+.Fn acl_add_perm "acl_permset_t permset_d" "acl_perm_t perm"
 .Sh DESCRIPTION
 .Fn acl_add_perm
 is a POSIX.1e call that adds the permission contained in
-.Ar perm
+.Fa perm
 to the permission set
-.Ar permset_d .
+.Fa permset_d .
 .Pp
 Note: it is not considered an error to attempt to add permissions
 that already exist in the permission set.
 .Sh RETURN VALUES
-Upon successful completion, the function will return a value of
-.Va 0 .
-Otherwise, a value of
-.Va -1
-will be returned, and
-.Va errno
-will be set to indicate the error.
+.Rv -std acl_add_perm
 .Sh ERRORS
-If any of the following conditions occur, the
+The
 .Fn acl_add_perm
-function will 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 permset_d
+.Fa permset_d
 is not a valid descriptor for a permission set within an ACL entry.
 Argument
-.Ar perm
+.Fa perm
 does not contain a valid
-.Ar acl_perm_t
+.Vt acl_perm_t
 value.
 .El
 .Sh SEE ALSO
diff --git a/lib/libc/posix1e/acl_clear_perms.3 b/lib/libc/posix1e/acl_clear_perms.3
index d41ab3e..1e327c8 100644
--- a/lib/libc/posix1e/acl_clear_perms.3
+++ b/lib/libc/posix1e/acl_clear_perms.3
@@ -26,11 +26,11 @@
 .\" $FreeBSD$
 .\"
 .Dd March 10, 2001
-.Dt ACL_CLEAR_PERM 3
+.Dt ACL_CLEAR_PERMS 3
 .Os
 .Sh NAME
 .Nm acl_clear_perms
-.Nd Clear permissions from a permission set
+.Nd clear permissions from a permission set
 .Sh LIBRARY
 .Lb libposix1e
 .Sh SYNOPSIS
@@ -41,27 +41,17 @@
 .Sh DESCRIPTION
 .Fn acl_clear_perms
 is a POSIX.1e call that clears all permissions from permissions set
-.Ar perm .
+.Fa permset_d .
 .Sh RETURN VALUES
-Upon successful completion, the function will return a value of
-.Va 0 .
-Otherwise, a value of
-.Va -1
-will be returned, and
-.Va errno
-will be set to indicate the error.
+.Rv -std acl_clear_perms
 .Sh ERRORS
-If the following condition occurs, the
+The
 .Fn acl_clear_perms
-function will 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 permset_d
+.Fa permset_d
 is not a valid descriptor for a permission set.
 .El
 .Sh SEE ALSO
diff --git a/lib/libc/posix1e/acl_copy_entry.3 b/lib/libc/posix1e/acl_copy_entry.3
index 5e18e60..ce8d60f 100644
--- a/lib/libc/posix1e/acl_copy_entry.3
+++ b/lib/libc/posix1e/acl_copy_entry.3
@@ -30,7 +30,7 @@
 .Os
 .Sh NAME
 .Nm acl_copy_entry
-.Nd Copy an ACL entry to another ACL entry
+.Nd copy an ACL entry to another ACL entry
 .Sh LIBRARY
 .Lb libposix1e
 .Sh SYNOPSIS
@@ -41,36 +41,26 @@
 .Sh DESCRIPTION
 .Fn acl_copy_entry
 is a POSIX.1e call that copies the contents of ACL entry
-.Ar src_d
+.Fa src_d
 to ACL entry
-.Ar dest_d .
+.Fa dest_d .
 .Sh RETURN VALUES
-Upon successful completion, the function will return a value of
-.Va 0 .
-Otherwise, a value of
-.Va -1
-will be returned, and
-.Va errno
-will be set to indicate the error.
+.Rv -std acl_copy_entry
 .Sh ERRORS
-If any of the following conditions occur, the
+The
 .Fn acl_copy_entry
-function will 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 src_d
+.Fa src_d
 or
-.Ar dest_d
+.Fa dest_d
 is not a valid descriptor for an ACL entry, or
 arguments
-.Ar src_d
+.Fa src_d
 and
-.Ar dest_d
+.Fa dest_d
 reference the same ACL entry.
 .El
 .Sh SEE ALSO
diff --git a/lib/libc/posix1e/acl_create_entry.3 b/lib/libc/posix1e/acl_create_entry.3
index c1e8cd3..1b94312 100644
--- a/lib/libc/posix1e/acl_create_entry.3
+++ b/lib/libc/posix1e/acl_create_entry.3
@@ -30,7 +30,7 @@
 .Os
 .Sh NAME
 .Nm acl_create_entry
-.Nd Create a new ACL entry
+.Nd create a new ACL entry
 .Sh LIBRARY
 .Lb libposix1e
 .Sh SYNOPSIS
@@ -42,27 +42,17 @@
 .Fn acl_create_entry
 is a POSIX.1e call that creates a new ACL entry in the ACL
 pointed to by
-.Ar acl_p.
+.Fa acl_p .
 .Sh RETURN VALUES
-Upon successful completion, the function will return a value of
-.Va 0 .
-Otherwise, a value of
-.Va -1
-will be returned, and
-.Va errno
-will be set to indicate the error.
+.Rv -std acl_create_entry
 .Sh ERRORS
-If one of the following conditions occur, the
+The
 .Fn acl_create_entry
-function will 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_p
+.Fa acl_p
 does not point to a pointer to a valid ACL.
 .It Bq Er ENOMEM
 The ACL working storage requires more memory than is
diff --git a/lib/libc/posix1e/acl_delete_perm.3 b/lib/libc/posix1e/acl_delete_perm.3
index 0a76623..1fbb51e 100644
--- a/lib/libc/posix1e/acl_delete_perm.3
+++ b/lib/libc/posix1e/acl_delete_perm.3
@@ -30,7 +30,7 @@
 .Os
 .Sh NAME
 .Nm acl_delete_perm
-.Nd Delete permissions from a permission set
+.Nd delete permissions from a permission set
 .Sh LIBRARY
 .Lb libposix1e
 .Sh SYNOPSIS
@@ -41,34 +41,22 @@
 .Sh DESCRIPTION
 .Fn acl_delete_perm
 is a POSIX.1e call that removes specific permissions from permissions set
-.Ar perm .
+.Fa perm .
 .Sh RETURN VALUES
-Upon successful completion, the function will return a value of
-.Va 0 .
-Otherwise, a value of
-.Va -1
-will be returned, and
-.Va errno
-will be set to indicate the error.
+.Rv -std acl_delete_perm
 .Sh ERRORS
-If one of the following conditions occur, the
+The
 .Fn acl_delete_perm
-function will 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 permset_d
+.Fa permset_d
 is not a valid descriptor for a permission set.  Argument
-.Ar perm
+.Fa perm
 does not contain a valid
-.Ar acl_perm_t
+.Vt acl_perm_t
 value.
-.It Bq Er ENOSYS
-This function is not supported by the implementation.
 .El
 .Sh SEE ALSO
 .Xr acl 3 ,
diff --git a/lib/libc/posix1e/acl_get_permset.3 b/lib/libc/posix1e/acl_get_permset.3
index 512246c..b607257 100644
--- a/lib/libc/posix1e/acl_get_permset.3
+++ b/lib/libc/posix1e/acl_get_permset.3
@@ -30,7 +30,7 @@
 .Os
 .Sh NAME
 .Nm acl_get_permset
-.Nd Retrieve permset from an ACL entry
+.Nd retrieve permission set from an ACL entry
 .Sh LIBRARY
 .Lb libposix1e
 .Sh SYNOPSIS
@@ -41,32 +41,21 @@
 .Sh DESCRIPTION
 .Fn acl_get_permset
 is a POSIX.1e call that returns via
-.Ar permset_p
+.Fa permset_p
 a descriptor to the permission set in the ACL entry
-.Ar entry_d .
+.Fa entry_d .
 Subsequent operations using the returned permission set operate
 on the permission set within the ACL entry.
-.Ar perm .
 .Sh RETURN VALUES
-Upon successful completion, the function will return a value of
-.Va 0 .
-Otherwise, a value of
-.Va -1
-will be returned, and
-.Va errno
-will be set to indicate the error.
+.Rv -std acl_get_permset
 .Sh ERRORS
-If the following condition occurs, the
+The
 .Fn acl_get_permset
-function will 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 entry_d
+.Fa entry_d
 is not a valid descriptor for an ACL entry.
 .El
 .Sh SEE ALSO
diff --git a/lib/libc/posix1e/acl_get_tag_type.3 b/lib/libc/posix1e/acl_get_tag_type.3
index a438e17..8294e1a 100644
--- a/lib/libc/posix1e/acl_get_tag_type.3
+++ b/lib/libc/posix1e/acl_get_tag_type.3
@@ -30,42 +30,32 @@
 .Os
 .Sh NAME
 .Nm acl_get_tag_type
-.Nd Calculate and set ACL mask permissions
+.Nd calculate and set ACL mask permissions
 .Sh LIBRARY
 .Lb libposix1e
 .Sh SYNOPSIS
 .Fd #include <sys/types.h>
 .Fd #include <sys/acl.h>
 .Ft int
-.Fn acl_get_tag_type "acl_entry_t entry_d, acl_tag_t *tag_type_p"
+.Fn acl_get_tag_type "acl_entry_t entry_d" "acl_tag_t *tag_type_p"
 .Sh DESCRIPTION
 .Fn acl_get_tag_type
 is a POSIX.1e call that returs the tag type for the ACL entry
-.Ar entry_d .
+.Fa entry_d .
 Upon successful completion, the location referred to by the argument
-.Ar tag_type_p
+.Fa tag_type_p
 will be set to the tag type of the ACL entry
-.Ar entry_d .
+.Fa entry_d .
 .Sh RETURN VALUES
-Upon successful completion, the function will return a value of
-.Va 0 .
-Otherwise, a value of
-.Va -1
-will be returned, and
-.Va errno
-will be set to indicate the error.
+.Rv -std acl_get_tag_type
 .Sh ERRORS
-If any of the following conditions occur, the
+The
 .Fn acl_get_tag_type
-function will 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 entry_d
+.Fa entry_d
 is not a valid descriptor for an ACL entry;
 .El
 .Sh SEE ALSO
diff --git a/lib/libc/posix1e/acl_set_qualifier.3 b/lib/libc/posix1e/acl_set_qualifier.3
index 430c194..6df659e 100644
--- a/lib/libc/posix1e/acl_set_qualifier.3
+++ b/lib/libc/posix1e/acl_set_qualifier.3
@@ -30,45 +30,39 @@
 .Os
 .Sh NAME
 .Nm acl_set_qualifier
-.Nd Set ACL tag qualifier
+.Nd set ACL tag qualifier
 .Sh LIBRARY
 .Lb libposix1e
 .Sh SYNOPSIS
 .Fd #include <sys/types.h>
 .Fd #include <sys/acl.h>
 .Ft int
-.Fn acl_set_qualifier "acl_entry_t entry_d, const void *tag_qualifier_p"
+.Fn acl_set_qualifier "acl_entry_t entry_d" "const void *tag_qualifier_p"
 .Sh DESCRIPTION
 .Fn acl_set_qualifier
 is a POSIX.1e call that sets the qualifier of the tag for the ACl entry
-.Ar entry_d
+.Fa entry_d
 to the value referred to by
-.Ar tag_qualifier_p .
+.Fa tag_qualifier_p .
 .Sh RETURN VALUES
-Upon successful completion, the function will return a value of
-.Va 0 .
-Otherwise, a value of
-.Va -1
-will be returned, and
-.Va errno
-will be set to indicate the error.
+.Rv -std acl_set_qualifier
 .Sh ERRORS
-If any of the following conditions occur, the
+The
 .Fn acl_set_qualifier
-function will 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 entry_d
+.Fa entry_d
 is not a valid descriptor for an ACL entry.  The tag type of the
 ACL entry
-.Ar entry_d
-is not ACL_USER or ACL_GROUP.  The value pointed to by
-.Ar tag_qualifier_p
+.Fa entry_d
+is not
+.Dv ACL_USER
+or
+.Dv ACL_GROUP .
+The value pointed to by
+.Fa tag_qualifier_p
 is not valid.
 .It Bq Er ENOMEM
 The value to be returned requires more memory than is allowed
diff --git a/lib/libposix1e/acl_add_perm.3 b/lib/libposix1e/acl_add_perm.3
index 7354d23..88b22fb 100644
--- a/lib/libposix1e/acl_add_perm.3
+++ b/lib/libposix1e/acl_add_perm.3
@@ -30,48 +30,38 @@
 .Os
 .Sh NAME
 .Nm acl_add_perm
-.Nd Add permissions to a permission set
+.Nd add permissions to a permission set
 .Sh LIBRARY
 .Lb libposix1e
 .Sh SYNOPSIS
 .Fd #include <sys/types.h>
 .Fd #include <sys/acl.h>
 .Ft int
-.Fn acl_add_perm "acl_permset_t permset_d, acl_perm_t perm"
+.Fn acl_add_perm "acl_permset_t permset_d" "acl_perm_t perm"
 .Sh DESCRIPTION
 .Fn acl_add_perm
 is a POSIX.1e call that adds the permission contained in
-.Ar perm
+.Fa perm
 to the permission set
-.Ar permset_d .
+.Fa permset_d .
 .Pp
 Note: it is not considered an error to attempt to add permissions
 that already exist in the permission set.
 .Sh RETURN VALUES
-Upon successful completion, the function will return a value of
-.Va 0 .
-Otherwise, a value of
-.Va -1
-will be returned, and
-.Va errno
-will be set to indicate the error.
+.Rv -std acl_add_perm
 .Sh ERRORS
-If any of the following conditions occur, the
+The
 .Fn acl_add_perm
-function will 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 permset_d
+.Fa permset_d
 is not a valid descriptor for a permission set within an ACL entry.
 Argument
-.Ar perm
+.Fa perm
 does not contain a valid
-.Ar acl_perm_t
+.Vt acl_perm_t
 value.
 .El
 .Sh SEE ALSO
diff --git a/lib/libposix1e/acl_clear_perms.3 b/lib/libposix1e/acl_clear_perms.3
index d41ab3e..1e327c8 100644
--- a/lib/libposix1e/acl_clear_perms.3
+++ b/lib/libposix1e/acl_clear_perms.3
@@ -26,11 +26,11 @@
 .\" $FreeBSD$
 .\"
 .Dd March 10, 2001
-.Dt ACL_CLEAR_PERM 3
+.Dt ACL_CLEAR_PERMS 3
 .Os
 .Sh NAME
 .Nm acl_clear_perms
-.Nd Clear permissions from a permission set
+.Nd clear permissions from a permission set
 .Sh LIBRARY
 .Lb libposix1e
 .Sh SYNOPSIS
@@ -41,27 +41,17 @@
 .Sh DESCRIPTION
 .Fn acl_clear_perms
 is a POSIX.1e call that clears all permissions from permissions set
-.Ar perm .
+.Fa permset_d .
 .Sh RETURN VALUES
-Upon successful completion, the function will return a value of
-.Va 0 .
-Otherwise, a value of
-.Va -1
-will be returned, and
-.Va errno
-will be set to indicate the error.
+.Rv -std acl_clear_perms
 .Sh ERRORS
-If the following condition occurs, the
+The
 .Fn acl_clear_perms
-function will 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 permset_d
+.Fa permset_d
 is not a valid descriptor for a permission set.
 .El
 .Sh SEE ALSO
diff --git a/lib/libposix1e/acl_copy_entry.3 b/lib/libposix1e/acl_copy_entry.3
index 5e18e60..ce8d60f 100644
--- a/lib/libposix1e/acl_copy_entry.3
+++ b/lib/libposix1e/acl_copy_entry.3
@@ -30,7 +30,7 @@
 .Os
 .Sh NAME
 .Nm acl_copy_entry
-.Nd Copy an ACL entry to another ACL entry
+.Nd copy an ACL entry to another ACL entry
 .Sh LIBRARY
 .Lb libposix1e
 .Sh SYNOPSIS
@@ -41,36 +41,26 @@
 .Sh DESCRIPTION
 .Fn acl_copy_entry
 is a POSIX.1e call that copies the contents of ACL entry
-.Ar src_d
+.Fa src_d
 to ACL entry
-.Ar dest_d .
+.Fa dest_d .
 .Sh RETURN VALUES
-Upon successful completion, the function will return a value of
-.Va 0 .
-Otherwise, a value of
-.Va -1
-will be returned, and
-.Va errno
-will be set to indicate the error.
+.Rv -std acl_copy_entry
 .Sh ERRORS
-If any of the following conditions occur, the
+The
 .Fn acl_copy_entry
-function will 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 src_d
+.Fa src_d
 or
-.Ar dest_d
+.Fa dest_d
 is not a valid descriptor for an ACL entry, or
 arguments
-.Ar src_d
+.Fa src_d
 and
-.Ar dest_d
+.Fa dest_d
 reference the same ACL entry.
 .El
 .Sh SEE ALSO
diff --git a/lib/libposix1e/acl_create_entry.3 b/lib/libposix1e/acl_create_entry.3
index c1e8cd3..1b94312 100644
--- a/lib/libposix1e/acl_create_entry.3
+++ b/lib/libposix1e/acl_create_entry.3
@@ -30,7 +30,7 @@
 .Os
 .Sh NAME
 .Nm acl_create_entry
-.Nd Create a new ACL entry
+.Nd create a new ACL entry
 .Sh LIBRARY
 .Lb libposix1e
 .Sh SYNOPSIS
@@ -42,27 +42,17 @@
 .Fn acl_create_entry
 is a POSIX.1e call that creates a new ACL entry in the ACL
 pointed to by
-.Ar acl_p.
+.Fa acl_p .
 .Sh RETURN VALUES
-Upon successful completion, the function will return a value of
-.Va 0 .
-Otherwise, a value of
-.Va -1
-will be returned, and
-.Va errno
-will be set to indicate the error.
+.Rv -std acl_create_entry
 .Sh ERRORS
-If one of the following conditions occur, the
+The
 .Fn acl_create_entry
-function will 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_p
+.Fa acl_p
 does not point to a pointer to a valid ACL.
 .It Bq Er ENOMEM
 The ACL working storage requires more memory than is
diff --git a/lib/libposix1e/acl_delete_perm.3 b/lib/libposix1e/acl_delete_perm.3
index 0a76623..1fbb51e 100644
--- a/lib/libposix1e/acl_delete_perm.3
+++ b/lib/libposix1e/acl_delete_perm.3
@@ -30,7 +30,7 @@
 .Os
 .Sh NAME
 .Nm acl_delete_perm
-.Nd Delete permissions from a permission set
+.Nd delete permissions from a permission set
 .Sh LIBRARY
 .Lb libposix1e
 .Sh SYNOPSIS
@@ -41,34 +41,22 @@
 .Sh DESCRIPTION
 .Fn acl_delete_perm
 is a POSIX.1e call that removes specific permissions from permissions set
-.Ar perm .
+.Fa perm .
 .Sh RETURN VALUES
-Upon successful completion, the function will return a value of
-.Va 0 .
-Otherwise, a value of
-.Va -1
-will be returned, and
-.Va errno
-will be set to indicate the error.
+.Rv -std acl_delete_perm
 .Sh ERRORS
-If one of the following conditions occur, the
+The
 .Fn acl_delete_perm
-function will 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 permset_d
+.Fa permset_d
 is not a valid descriptor for a permission set.  Argument
-.Ar perm
+.Fa perm
 does not contain a valid
-.Ar acl_perm_t
+.Vt acl_perm_t
 value.
-.It Bq Er ENOSYS
-This function is not supported by the implementation.
 .El
 .Sh SEE ALSO
 .Xr acl 3 ,
diff --git a/lib/libposix1e/acl_get_permset.3 b/lib/libposix1e/acl_get_permset.3
index 512246c..b607257 100644
--- a/lib/libposix1e/acl_get_permset.3
+++ b/lib/libposix1e/acl_get_permset.3
@@ -30,7 +30,7 @@
 .Os
 .Sh NAME
 .Nm acl_get_permset
-.Nd Retrieve permset from an ACL entry
+.Nd retrieve permission set from an ACL entry
 .Sh LIBRARY
 .Lb libposix1e
 .Sh SYNOPSIS
@@ -41,32 +41,21 @@
 .Sh DESCRIPTION
 .Fn acl_get_permset
 is a POSIX.1e call that returns via
-.Ar permset_p
+.Fa permset_p
 a descriptor to the permission set in the ACL entry
-.Ar entry_d .
+.Fa entry_d .
 Subsequent operations using the returned permission set operate
 on the permission set within the ACL entry.
-.Ar perm .
 .Sh RETURN VALUES
-Upon successful completion, the function will return a value of
-.Va 0 .
-Otherwise, a value of
-.Va -1
-will be returned, and
-.Va errno
-will be set to indicate the error.
+.Rv -std acl_get_permset
 .Sh ERRORS
-If the following condition occurs, the
+The
 .Fn acl_get_permset
-function will 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 entry_d
+.Fa entry_d
 is not a valid descriptor for an ACL entry.
 .El
 .Sh SEE ALSO
diff --git a/lib/libposix1e/acl_get_tag_type.3 b/lib/libposix1e/acl_get_tag_type.3
index a438e17..8294e1a 100644
--- a/lib/libposix1e/acl_get_tag_type.3
+++ b/lib/libposix1e/acl_get_tag_type.3
@@ -30,42 +30,32 @@
 .Os
 .Sh NAME
 .Nm acl_get_tag_type
-.Nd Calculate and set ACL mask permissions
+.Nd calculate and set ACL mask permissions
 .Sh LIBRARY
 .Lb libposix1e
 .Sh SYNOPSIS
 .Fd #include <sys/types.h>
 .Fd #include <sys/acl.h>
 .Ft int
-.Fn acl_get_tag_type "acl_entry_t entry_d, acl_tag_t *tag_type_p"
+.Fn acl_get_tag_type "acl_entry_t entry_d" "acl_tag_t *tag_type_p"
 .Sh DESCRIPTION
 .Fn acl_get_tag_type
 is a POSIX.1e call that returs the tag type for the ACL entry
-.Ar entry_d .
+.Fa entry_d .
 Upon successful completion, the location referred to by the argument
-.Ar tag_type_p
+.Fa tag_type_p
 will be set to the tag type of the ACL entry
-.Ar entry_d .
+.Fa entry_d .
 .Sh RETURN VALUES
-Upon successful completion, the function will return a value of
-.Va 0 .
-Otherwise, a value of
-.Va -1
-will be returned, and
-.Va errno
-will be set to indicate the error.
+.Rv -std acl_get_tag_type
 .Sh ERRORS
-If any of the following conditions occur, the
+The
 .Fn acl_get_tag_type
-function will 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 entry_d
+.Fa entry_d
 is not a valid descriptor for an ACL entry;
 .El
 .Sh SEE ALSO
diff --git a/lib/libposix1e/acl_set_qualifier.3 b/lib/libposix1e/acl_set_qualifier.3
index 430c194..6df659e 100644
--- a/lib/libposix1e/acl_set_qualifier.3
+++ b/lib/libposix1e/acl_set_qualifier.3
@@ -30,45 +30,39 @@
 .Os
 .Sh NAME
 .Nm acl_set_qualifier
-.Nd Set ACL tag qualifier
+.Nd set ACL tag qualifier
 .Sh LIBRARY
 .Lb libposix1e
 .Sh SYNOPSIS
 .Fd #include <sys/types.h>
 .Fd #include <sys/acl.h>
 .Ft int
-.Fn acl_set_qualifier "acl_entry_t entry_d, const void *tag_qualifier_p"
+.Fn acl_set_qualifier "acl_entry_t entry_d" "const void *tag_qualifier_p"
 .Sh DESCRIPTION
 .Fn acl_set_qualifier
 is a POSIX.1e call that sets the qualifier of the tag for the ACl entry
-.Ar entry_d
+.Fa entry_d
 to the value referred to by
-.Ar tag_qualifier_p .
+.Fa tag_qualifier_p .
 .Sh RETURN VALUES
-Upon successful completion, the function will return a value of
-.Va 0 .
-Otherwise, a value of
-.Va -1
-will be returned, and
-.Va errno
-will be set to indicate the error.
+.Rv -std acl_set_qualifier
 .Sh ERRORS
-If any of the following conditions occur, the
+The
 .Fn acl_set_qualifier
-function will 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 entry_d
+.Fa entry_d
 is not a valid descriptor for an ACL entry.  The tag type of the
 ACL entry
-.Ar entry_d
-is not ACL_USER or ACL_GROUP.  The value pointed to by
-.Ar tag_qualifier_p
+.Fa entry_d
+is not
+.Dv ACL_USER
+or
+.Dv ACL_GROUP .
+The value pointed to by
+.Fa tag_qualifier_p
 is not valid.
 .It Bq Er ENOMEM
 The value to be returned requires more memory than is allowed