The .Fn function

10 files changed, 43 insertions, 33 deletions

diff --git a/lib/libc/compat-43/sigvec.2 b/lib/libc/compat-43/sigvec.2
index 4a0db25..b758416 100644
--- a/lib/libc/compat-43/sigvec.2
+++ b/lib/libc/compat-43/sigvec.2
@@ -236,8 +236,9 @@ or
 all signals, the signal mask, the signal stack,
 and the restart/interrupt flags are inherited by the child.
 .Pp
-.Xr Execve 2
-reinstates the default
+The
+.Xr execve 2
+system call reinstates the default
 action for all signals which were caught and
 resets all signals to be caught on the user stack.
 Ignored signals remain ignored;
diff --git a/lib/libc/db/man/mpool.3 b/lib/libc/db/man/mpool.3
index 965be55..32714cf 100644
--- a/lib/libc/db/man/mpool.3
+++ b/lib/libc/db/man/mpool.3
@@ -61,14 +61,15 @@
 .Ft int
 .Fn mpool_close "MPOOL *mp"
 .Sh DESCRIPTION
-.Nm Mpool
-is the library interface intended to provide page oriented buffer management
+The
+.Nm mpool
+library interface is intended to provide page oriented buffer management
 of files.
 The buffers may be shared between processes.
 .Pp
-The function
+The
 .Fn mpool_open
-initializes a memory pool.
+function initializes a memory pool.
 The
 .Fa key
 argument is the byte string used to negotiate between multiple
@@ -118,9 +119,9 @@ Both functions are called with the
 .Fa pgcookie
 pointer, the page number and a pointer to the page to being read or written.
 .Pp
-The function
+The
 .Fn mpool_new
-takes an
+function takes an
 .Ft MPOOL
 pointer and an address as arguments.
 If a new page can be allocated, a pointer to the page is returned and
@@ -133,9 +134,9 @@ is returned and
 .Va errno
 is set.
 .Pp
-The function
+The
 .Fn mpool_get
-takes a
+function takes a
 .Ft MPOOL
 pointer and a page number as arguments.
 If the page exists, a pointer to the page is returned.
@@ -148,9 +149,9 @@ The
 .Fa flags
 argument is not currently used.
 .Pp
-The function
+The
 .Fn mpool_put
-unpins the page referenced by
+function unpins the page referenced by
 .Fa pgaddr .
 The
 .Fa pgaddr
@@ -174,9 +175,9 @@ The
 function
 returns 0 on success and -1 if an error occurs.
 .Pp
-The function
+The
 .Fn mpool_sync
-writes all modified pages associated with the
+function writes all modified pages associated with the
 .Ft MPOOL
 pointer to the
 backing file.
diff --git a/lib/libc/locale/mbrune.3 b/lib/libc/locale/mbrune.3
index d6f66c1..20e142e 100644
--- a/lib/libc/locale/mbrune.3
+++ b/lib/libc/locale/mbrune.3
@@ -156,7 +156,7 @@ or
 if the
 .Fa pattern
 does not appear in the string.
-.Sh "SEE ALSO
+.Sh SEE ALSO
 .Xr rune 3 ,
 .Xr setlocale 3 ,
 .Xr euc 4 ,
diff --git a/lib/libc/locale/multibyte.3 b/lib/libc/locale/multibyte.3
index 8988eb6..6377eda 100644
--- a/lib/libc/locale/multibyte.3
+++ b/lib/libc/locale/multibyte.3
@@ -221,7 +221,7 @@ function returns the number of bytes converted,
 not counting any terminating null byte.
 If any invalid multibyte characters are encountered,
 both functions return \-1.
-.Sh "SEE ALSO
+.Sh SEE ALSO
 .Xr btowc 3 ,
 .Xr mbrlen 3 ,
 .Xr mbrtowc 3 ,
diff --git a/lib/libc/net/gethostbyname.3 b/lib/libc/net/gethostbyname.3
index c6f7b90..ff20251 100644
--- a/lib/libc/net/gethostbyname.3
+++ b/lib/libc/net/gethostbyname.3
@@ -378,5 +378,6 @@ function
 cannot perform
 .Dv AF_INET6
 lookups over NIS.
+The
 .Xr getaddrinfo 3
-must be used instead.
+function must be used instead.
diff --git a/lib/libc/net/nsdispatch.3 b/lib/libc/net/nsdispatch.3
index 7839ab0..b87d122 100644
--- a/lib/libc/net/nsdispatch.3
+++ b/lib/libc/net/nsdispatch.3
@@ -189,9 +189,10 @@ Refer to
 .Xr nsswitch.conf 5
 for a complete description of what each status code is.
 .Pp
-.Nm
-returns the value of the callback that caused the dispatcher to finish,
-or NS_NOTFOUND otherwise.
+The
+.Fn nsdispatch
+function returns the value of the callback that caused the dispatcher to
+finish, or NS_NOTFOUND otherwise.
 .Sh SEE ALSO
 .Xr hesiod 3 ,
 .Xr stdarg 3 ,
@@ -199,13 +200,13 @@ or NS_NOTFOUND otherwise.
 .Xr nsswitch.conf 5
 .Sh HISTORY
 The
-.Nm
-routines first appeared in
+.Fn nsdispatch
+function first appeared in
 .Fx 5.0 .
-They were imported from the
+It was imported from the
 .Nx
 Project,
-where they appeared first in
+where it appeared first in
 .Nx 1.4 .
 .Sh AUTHORS
 Luke Mewburn
@@ -220,8 +221,8 @@ and
 manual pages.
 .Sh BUGS
 The
-.Nm
-routines are not thread safe.
+.Fn nsdispatch
+function is not thread safe.
 This will be rectified in the future.
 .Pp
 Currently there is no support for dynamically loadable dispatcher callback
diff --git a/lib/libc/posix1e/acl.3 b/lib/libc/posix1e/acl.3
index 966f4d1..1c824d0 100644
--- a/lib/libc/posix1e/acl.3
+++ b/lib/libc/posix1e/acl.3
@@ -234,10 +234,11 @@ POSIX.1e support was introduced in
 was the first version to include a complete ACL implementation based
 on extended attributes for the UFS and UFS2 file systems.
 .Pp
+The
 .Xr getfacl 1
 and
 .Xr setfacl 1
-describe the user tools that permit direct manipulation of complete file
-ACLs.
+utilities describe the user tools that permit direct manipulation of complete
+file ACLs.
 .Sh AUTHORS
 .An Robert N M Watson
diff --git a/lib/libc/posix1e/acl_get.3 b/lib/libc/posix1e/acl_get.3
index e39c0a4..0899bf3 100644
--- a/lib/libc/posix1e/acl_get.3
+++ b/lib/libc/posix1e/acl_get.3
@@ -67,8 +67,9 @@ function
 is a non-portable form of
 .Fn acl_get_fd
 that allows the retrieval of any type of ACL from a file descriptor.
+The
 .Fn acl_get_file
-is a POSIX.1e call that allows the retrieval of a
+function is a POSIX.1e call that allows the retrieval of a
 specified type of ACL from a file by name;
 .Fn acl_get_link_np
 is a non-portable variation on
diff --git a/lib/libc/posix1e/acl_set.3 b/lib/libc/posix1e/acl_set.3
index 6a1c39b..72fdd41 100644
--- a/lib/libc/posix1e/acl_set.3
+++ b/lib/libc/posix1e/acl_set.3
@@ -60,17 +60,20 @@ each associate an ACL with an object referred to by
 .Va fd
 or
 .Va path_p .
+The
 .Fn acl_set_fd_np
 and
 .Fn acl_set_link_np
-are not POSIX.1e calls.
+functions are not POSIX.1e calls.
+The
 .Fn acl_set_fd
-allows only the setting of ACLs of type ACL_TYPE_ACCESS
+function allows only the setting of ACLs of type ACL_TYPE_ACCESS
 where as
 .Fn acl_set_fd_np
 allows the setting of ACLs of any type.
+The
 .Fn acl_set_link_np
-acts on a symlink rather than its target, if the target of the
+function acts on a symlink rather than its target, if the target of the
 path is a symlink.
 .Sh IMPLEMENTATION NOTES
 .Fx Ns 's
diff --git a/lib/libc/rpc/rpc_soc.3 b/lib/libc/rpc/rpc_soc.3
index 453c45d..ebc666b 100644
--- a/lib/libc/rpc/rpc_soc.3
+++ b/lib/libc/rpc/rpc_soc.3
@@ -1454,8 +1454,9 @@ at most 104 characters.
 This file is
 .Em not
 removed when the socket is closed.
+The
 .Xr unlink 2
-must be used to remove the file.
+system call must be used to remove the file.
 Upon completion,
 .Fa xprt\->xp_fd
 is the transport's socket descriptor.