This is the mail archive of the
libc-alpha@sourceware.org
mailing list for the glibc project.
Re: [PATCH] pldd.1: Document glibc's unbreakage of tool.
- From: "Michael Kerrisk (man-pages)" <mtk dot manpages at gmail dot com>
- To: Carlos O'Donell <carlos at redhat dot com>, "G. Branden Robinson" <g dot branden dot robinson at gmail dot com>
- Cc: mtk dot manpages at gmail dot com, Florian Weimer <fweimer at redhat dot com>, linux-man <linux-man at vger dot kernel dot org>, GNU C Library <libc-alpha at sourceware dot org>
- Date: Mon, 29 Jul 2019 21:18:15 +0200
- Subject: Re: [PATCH] pldd.1: Document glibc's unbreakage of tool.
- References: <20190511072049.2w7pp723iszp3gra@localhost.localdomain> <8736liit24.fsf@oldenburg2.str.redhat.com> <20190513141746.mail6ny43wh4t5oj@localhost.localdomain> <87y335m6fq.fsf@oldenburg2.str.redhat.com> <20190517155057.vr5uk6hfkyp44y3t@localhost.localdomain> <CAEMqeSrCMFZ8GQU=kR_+KXaqnd9m-3qUSQk1PNZ2xHjZ_YVHFg@mail.gmail.com>
On 5/17/19 5:56 PM, Carlos O'Donell wrote:
> On Fri, May 17, 2019 at 11:51 AM G. Branden Robinson
> <g.branden.robinson@gmail.com> wrote:
>> What would you prefer? That the man page not document the bug at all?
>> Was it a mistake in your view to have added the information about the
>> bug to the man page in the first place?
>
> I think having the glibc upstream version information is useful.
And so do I. My compromise in such cases is to write something like:
this:
BUGS
From glibc 2.19 to 2.29, pldd was broken: it just hung when exe‐
cuted. This problem was fixed in glibc 2.30, and the fix has been
backported to earlier glibc versions in some distributions.
Thanks,
Michael
--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/