1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69
|
Description: Fix for incorrect struct docs in texi
Author: Hans Ulrich Niedermann.
Last-Updated: 2021-01-04
Forwarded: no
Bug-Debian: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=304400
Index: libtool-2.4.6/doc/libtool.texi
===================================================================
--- libtool-2.4.6.orig/doc/libtool.texi
+++ libtool-2.4.6/doc/libtool.texi
@@ -3524,9 +3524,9 @@ using the @option{-dlopen} or @option{-d
program (@pxref{Link mode}).
@deftp {Data Type} {lt_dlsymlist} typedef struct @
- @{ @w{const char *@var{name};} @w{void *@var{address};} @} lt_dlsymlist
-The @var{name} attribute is a null-terminated character string of the
-symbol name, such as @code{"fprintf"}. The @var{address} attribute is a
+ @{ @w{const char *@code{name};} @w{void *@code{address};} @} lt_dlsymlist
+The @code{name} attribute is a null-terminated character string of the
+symbol name, such as @code{"fprintf"}. The @code{address} attribute is a
generic pointer to the appropriate object, such as @code{&fprintf}.
@end deftp
@@ -3534,10 +3534,10 @@ generic pointer to the appropriate objec
An array of @code{lt_dlsymlist} structures, representing all the preloaded
symbols linked into the program proper. For each module
@option{-dlpreopen}ed by the Libtool linked program
-there is an element with the @var{name} of the module and an @var{address}
+there is an element with the @code{name} of the module and an @code{address}
of @code{0}, followed by all symbols exported from this file.
For the executable itself the special name @samp{@@PROGRAM@@} is used.
-The last element of all has a @var{name} and @var{address} of
+The last element of all has a @code{name} and @code{address} of
@code{0}.
To facilitate inclusion of symbol lists into libraries,
@@ -4295,16 +4295,16 @@ Some of the internal information about e
maintained by libltdl is available to the user, in the form of this
structure:
-@deftypefn {Type} {struct} lt_dlinfo @{ @w{char *@var{filename};} @
- @w{char *@var{name};} @w{int @var{ref_count};} @
- @w{int @var{is_resident};} @w{int @var{is_symglobal};} @
- @w{int @var{is_symlocal};}@}
+@deftypefn {Type} {struct} lt_dlinfo @{ @w{char *@code{filename};} @
+ @w{char *@code{name};} @w{int @code{ref_count};} @
+ @w{int @code{is_resident};} @w{int @code{is_symglobal};} @
+ @w{int @code{is_symlocal};}@}
@code{lt_dlinfo} is used to store information about a module.
-The @var{filename} attribute is a null-terminated character string of
+The @code{filename} attribute is a null-terminated character string of
the real module file name. If the module is a libtool module then
-@var{name} is its module name (e.g.@: @code{"libfoo"} for
+@code{name} is its module name (e.g.@: @code{"libfoo"} for
@code{"dir/libfoo.la"}), otherwise it is set to @code{NULL}. The
-@var{ref_count} attribute is a reference counter that describes how
+@code{ref_count} attribute is a reference counter that describes how
often the same module is currently loaded. The remaining fields can
be compared to any hints that were passed to @code{lt_dlopenadvise}
to determine whether the underlying loader was able to follow them.
@@ -4519,7 +4519,7 @@ level types.
@code{lt_user_data} is used for specifying loader instance data.
@end deftp
-@deftypefn {Type} {struct} lt_user_dlloader @{@w{const char *@var{sym_prefix};} @w{lt_module_open *@var{module_open};} @w{lt_module_close *@var{module_close};} @w{lt_find_sym *@var{find_sym};} @w{lt_dlloader_exit *@var{dlloader_exit};} @}
+@deftypefn {Type} {struct} lt_user_dlloader @{@w{const char *@code{sym_prefix};} @w{lt_module_open *@code{module_open};} @w{lt_module_close *@code{module_close};} @w{lt_find_sym *@code{find_sym};} @w{lt_dlloader_exit *@code{dlloader_exit};} @}
If you want to define a new way to open dynamic modules, and have the
@code{lt_dlopen} API use it, you need to instantiate one of these
structures and pass it to @code{lt_dlloader_add}. You can pass whatever
|