[src/trunk]: src/share/man/man3 Miscellaneous fixes.

[uwe <uwe%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/ea99424a0839
branches:  trunk
changeset: 467102:ea99424a0839
user:      uwe <uwe%NetBSD.org@localhost>
date:      Mon Jan 13 14:10:52 2020 +0000

description:
Miscellaneous fixes.

No space after asterisk in "type *arg".
There's no "-width indent", use something relevant instead.
Do not document the structure tag of the Link_map typedef.
Give the Link_map members a paragraph of their own for readability.
Give them a bit more breathing space in the tagged list.
Spell pooka's name correctly.

TODO: The text is pleonastic in several places ("Do foo.  On success
does foo." etc) and could use some copy editing.

diffstat:

 share/man/man3/dlinfo.3 |  22 ++++++++++++----------
 1 files changed, 12 insertions(+), 10 deletions(-)

diffs (75 lines):

diff -r 3fcef50bf0a1 -r ea99424a0839 share/man/man3/dlinfo.3
--- a/share/man/man3/dlinfo.3   Mon Jan 13 12:53:46 2020 +0000
+++ b/share/man/man3/dlinfo.3   Mon Jan 13 14:10:52 2020 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: dlinfo.3,v 1.3 2020/01/13 11:47:06 wiz Exp $
+.\"    $NetBSD: dlinfo.3,v 1.4 2020/01/13 14:10:52 uwe Exp $
 .\"
 .\" Copyright (c) 2003 Alexey Zelkin <phantom%FreeBSD.org@localhost>
 .\" All rights reserved.
@@ -40,7 +40,7 @@
 .In link.h
 .In dlfcn.h
 .Ft int
-.Fn dlinfo "void * handle" "int request" "void * p"
+.Fn dlinfo "void *handle" "int request" "void *p"
 .Sh DESCRIPTION
 The
 .Fn dlinfo
@@ -66,19 +66,20 @@
 the information returned by the
 .Fn dlinfo
 function pertains to the specified object.
-If handle is the special handle
+If
+.Fa handle
+is the special handle
 .Dv RTLD_SELF ,
 the information returned pertains to the caller itself.
 .Pp
 Possible values for the
 .Fa request
 argument are:
-.Bl -tag -width indent
+.Bl -tag -width "Dv RTLD_"
 .It Dv RTLD_DI_LINKMAP
-Retrieve the
+Retrieve the pointer to the
 .Vt Link_map
-.Pq Vt "struct link_map"
-structure pointer for the specified
+for the specified
 .Fa handle .
 On successful return, the
 .Fa p
@@ -98,6 +99,7 @@
 and
 .Xr dlclose 3
 are called.
+.Pp
 The
 .Vt Link_map
 structure is defined in
@@ -113,11 +115,11 @@
 struct link_map *l_next,   /* linked list of mapped libs */
                 *l_prev;
 .Ed
-.Bl -tag -width ".Va l_addr"
+.Bl -tag -width Va
 .It Va l_addr
 The base address of the object loaded into memory.
 .It Va l_name
-The full name of the loaded shared object.
+The absolute pathname of the loaded shared object.
 .It Va l_ld
 The address of the dynamic linking information segment
 .Pq Dv PT_DYNAMIC
@@ -273,7 +275,7 @@
 implementation of the
 .Fn dlinfo
 function was originally written by
-.An Antii Kantee Aq Mt pooka%NetBSD.org@localhost .
+.An Antti Kantee Aq Mt pooka%NetBSD.org@localhost .
 .Pp
 The manual page for this function was written by
 .An Alexey Zelkin Aq Mt phantom%FreeBSD.org@localhost