Re: Bug#473458: manpages-dev: dlopen man page contradicts ld.so(8)
On Fri, Apr 18, 2008 at 9:42 PM, Justin Pryzby
<justinpryzby@users.sourceforge.net> wrote:
> 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/
Done.
> s/resolval/resolution/
Done.
> s/linked with/& the/
Done * 2.
> s/set to non/set to a non/ (multiple times)
Done * 4.
> s/Do not update ... and/Update neither .../
I think that text is okay as is.
> Instead of "various places", say "in the following order".
Done.
> Include content regarding:
>
> LD_ASSUME_KERNEL: (with fix: s/multiple version is/multiple
> versions are/)
>
> $PLATFORM: (or uncomment this) (with fix: s/specifcation/specification/)
Can you send me the source of the Debian page?
> I think glibc should drop ld.so.8.
I'm inclined to agree, but will want to review the Debian page more
closely first.
Cheers,
Michael
> 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).
>
>
--
Michael Kerrisk
Maintainer of the Linux man-pages project
http://www.kernel.org/doc/man-pages/
Want to report a man-pages bug? Look here:
http://www.kernel.org/doc/man-pages/reporting_bugs.html
Reply to: