[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Bug#473458: manpages-dev: dlopen man page contradicts ld.so(8)



reassign 473458 libc6,manpages
thanks

On Fri, Apr 18, 2008 at 08:15:43PM +0200, Michael Kerrisk wrote:
> On Fri, Apr 18, 2008 at 6:35 PM, Justin Pryzby
> <justinpryzby@users.sourceforge.net> wrote:
> > user libc6@packages.debian.org
> > usertag 473458 debian-specific
> > thanks
> >
> > On Fri, Apr 18, 2008 at 06:52:12PM +0200, Michael Kerrisk wrote:
> > > Justin Pryzby wrote:
> > > > reassign 473458 libc6
> > > > found 473458 2.7-9
> > > > thanks
> > > >
> > > > On Sun, Mar 30, 2008 at 09:48:46PM +0300, ygrek wrote:

> > > > But I think it's sufficiently accurate to say that the /lib heirarchy
> > > > is searched before that of /usr/lib, so ld.so.8 is wrong, thus
> > > > reassigning.
> > >
> > > This correct.  NOTE: this bad text is in a Debian downstream patch.  The
> > > usptream page is  correct on this point (and has been forever, AFAICS)
> > The ld.so manpage seems to be introduced (not patched) by Debian's
> > diff.  Where does the ld.so.8 page used by the rest of the world come
> > from?  Does redhat or someone else maintain another page (separate
> > from both glibc upstream and Debian).
> 
> It's in my set; ld.so.8 is one of the few section 8 pages in upstream man-pages.
Thanks for pointing that out.

I don't know the history behind the libc6 package vs. manpages package
inclusion of ld.so.8.  It seems to me that manpages is the way to go.
I note these differences:

  . /etc/ld.so.nohwcap; this might be debian-specific, eg. for
    multi-arch.
  . The entirely of sections BUGS, NOTES, AUTHORS, COLOPHON;
  . the libc6 page suffers from bug#365112, fixed in manpages;
  . man-pages has a more complete and correct description of the
    search order (This is the initial bug report);
  . man-pages has better hyphenation escaping;
  . man-pages fixes typo LD_(DEBUG|PROFILE)_OUTPUT
  . includes LD_*: SHOW_AUXV, HWCAP_MASK, ORIGIN_PATH, DYNAMIC_WEAK
  . includes libc5-specific LD_*: KEEPDIR, ARGV0

Suggested fixes to the man-pages content to make it better than the
libc6 content in every way:
  s/indirectly through/indirectly by/
  s/resolval/resolution/ 
  s/linked with/& the/
  s/set to non/set to a non/ (multiple times)
  s/Do not update ... and/Update neither .../

  Instead of "various places", say "in the following order".

  Include content regarding:
  
	LD_ASSUME_KERNEL: (with fix: s/multiple version is/multiple
	versions are/)

	$PLATFORM: (or uncomment this) (with fix: s/specifcation/specification/)

I think glibc should drop ld.so.8.  The manpages copy seems to be more
easily made to be the best of the two, and gets wider visibility so
can be reasonably expected to remain so.  Any debian-specific linker
changes (perhaps including ld.so.conf.d?) can get included in the
debian diff to man-pages.  That seems a preferable situation to
including an  separately-maintained and undiffably-different manpage
in libc6, which includes only very few manpages (and only for normal
executables and the configuration file gai.conf).


Reply to: