[src/trunk]: src/share/man/man3 Minor tweaks.

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

details:   https://anonhg.NetBSD.org/src/rev/0730724ea63c
branches:  trunk
changeset: 847995:0730724ea63c
user:      uwe <uwe%NetBSD.org@localhost>
date:      Mon Jan 13 15:54:48 2020 +0000

description:
Minor tweaks.

Use same -indent for lists of values that are OR'ed as one argument.
Use consistent markup for dli_* member names.
Untabify Dl_info definition so that it lines up in PS output.

diffstat:

 share/man/man3/dlfcn.3 |  34 +++++++++++++++++-----------------
 1 files changed, 17 insertions(+), 17 deletions(-)

diffs (99 lines):

diff -r ae693c79bf04 -r 0730724ea63c share/man/man3/dlfcn.3
--- a/share/man/man3/dlfcn.3    Mon Jan 13 14:25:06 2020 +0000
+++ b/share/man/man3/dlfcn.3    Mon Jan 13 15:54:48 2020 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: dlfcn.3,v 1.36 2020/01/13 11:44:02 wiz Exp $
+.\"    $NetBSD: dlfcn.3,v 1.37 2020/01/13 15:54:48 uwe Exp $
 .\"
 .\" Copyright (c) 1998 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -104,7 +104,7 @@
 .Fa mode
 parameter specifies symbol resolution time and symbol visibility.
 One of the following values may be used to specify symbol resolution time:
-.Bl -tag -width "RTLD_GLOBALXX" -offset indent
+.Bl -tag -width "Dv RTLD_NODELETE" -offset indent
 .It Dv RTLD_NOW
 Symbols are resolved immediately.
 .It Dv RTLD_LAZY
@@ -113,7 +113,7 @@
 .El
 .Pp
 One of the following values may be used to specify symbol visibility:
-.Bl -tag -width "RTLD_GLOBALXX" -offset indent
+.Bl -tag -width "Dv RTLD_NODELETE" -offset indent
 .It Dv RTLD_GLOBAL
 The object's symbols and the symbols of its dependencies will be visible to
 other objects.
@@ -135,12 +135,12 @@
 Additionally, one of the following flags may be ORed into the
 .Fa mode
 argument:
-.Bl -tag -width "RTLD_NODELETEXX" -offset indent
+.Bl -tag -width "Dv RTLD_NODELETE" -offset indent
 .It Dv RTLD_NODELETE
 Prevents unload of the loaded object on
 .Fn dlclose .
 The same behaviour may be requested by
-.Fl "z nodelete"
+.Fl z Cm nodelete
 option of the static linker
 .Xr ld 1 .
 .It Dv RTLD_NOLOAD
@@ -256,10 +256,10 @@
 the value passed in the first argument
 .Fa addr .
 The symbols of a shared object are only eligible if
-.Va addr
+.Fa addr
 is between the base address of the shared object and the value of the
 symbol
-.Dq _end
+.Va _end
 in the same shared object.
 If no object for which this condition holds
 true can be found,
@@ -272,23 +272,23 @@
 The
 .Fa dli
 argument points at a caller-provided
-.Va Dl_info
+.Vt Dl_info
 structure defined as follows:
 .Bd -literal -offset indent
 typedef struct {
-       const char  *dli_fname;     /* File defining the symbol */
-       void        *dli_fbase;     /* Base address */
-       const char  *dli_sname;     /* Symbol name */
-       const void  *dli_saddr;     /* Symbol address */
+        const char  *dli_fname;     /* File defining the symbol */
+        void        *dli_fbase;     /* Base address */
+        const char  *dli_sname;     /* Symbol name */
+        const void  *dli_saddr;     /* Symbol address */
 } Dl_info;
 .Ed
 .Pp
 The structure members are further described as follows:
-.Bl -tag -width "dli_fnameXX"
-.It Li "dli_fname"
+.Bl -tag -width "Va"
+.It Va dli_fname
 The pathname of the shared object containing the address
 .Fa addr .
-.It Li "dli_fbase"
+.It Va dli_fbase
 The base address at which this shared object is loaded in the process
 address space.
 This may be zero if the symbol was found in the internally generated
@@ -299,9 +299,9 @@
 .Xr link 5
 .Pc
 which is not associated with a file.
-.It Li "dli_sname"
+.It Va dli_sname
 points at the nul-terminated name of the selected symbol
-.It Li "dli_saddr"
+.It Va dli_saddr
 is the actual address
 .Pq as it appears in the process address space
 of the symbol.