Re: libtool.texi: need_lib_prefix doc

[Gary V. Vaughan]

Hi Ralf,

Ralf Wildenhues wrote:
> This description looks fishy to me: (use fixed-width font)

Agreed!

> ,-- doc/libtool.texi (libtool script contents)
> |
> | @defvar need_lib_prefix
> | Whether libtool should automatically prefix module names with 'lib'.
> | Set to @samp{yes} or @samp{no}.  By default, it is @samp{unknown}, which
> | means the same as @samp{yes}, but documents that we are not really sure
> | about it.
> | @samp{yes} means that it is possible both to @code{dlopen} and to
>         ^^^
> Either this needs to be `no', or there is a `neither' missing in this
> sentence..

I think the comment in the libtool script explains better:

# Do we need the "lib" prefix for modules?
need_lib_prefix=no

Having looked at the code in ltmain.m4sh, how about using this in libtool.texi:

@defvar need_lib_prefix
Whether we can @code{dlopen} modules without a @samp{lib} prefix.
Set to @samp{yes} or @samp{no}.  By default, it is @samp{unknown}, which
means the same as @samp{yes}, but documents that we are not really sure
about it.  @samp{no} means that it is possible to @code{dlopen} a
module without the @samp{lib} prefix.

> | link against a library without 'lib' prefix,
> | i.e. it requires @var{hardcode_direct} to be @samp{yes}.
> | @end defvar
> 
> .. but since I haven't grasped the hardcode_direct addendum:
> Which is the right way?


I think the addendum is trying to say: the library rpath needs to be set at
linktime in order for the runtime loader to find a library named without the
`lib' prefix.

That may, or may not be true.  Either way, I don't see how the value in
need_lib_prefix is affected by that consideration, so I think we can safely
drop that part of the description.

Cheers,
        Gary.
-- 
Gary V. Vaughan      ())_.  address@hidden,gnu.org}
Research Scientist   ( '/   http://tkd.kicks-ass.net
GNU Hacker           / )=   http://www.gnu.org/software/libtool
Technical Author   `(_~)_   http://sources.redhat.com/autobook

signature.asc
Description: OpenPGP digital signature