This is the mail archive of the
libc-alpha@sourceware.org
mailing list for the glibc project.
Re: [MTASCsft PATCH WIP5 01/33] Multi Thread, Async Signal and Async Cancel safety documentation: intro
- From: "Carlos O'Donell" <carlos at redhat dot com>
- To: "Joseph S. Myers" <joseph at codesourcery dot com>, Alexandre Oliva <aoliva at redhat dot com>
- Cc: libc-alpha at sourceware dot org, mtk dot manpages at gmail dot com
- Date: Mon, 18 Nov 2013 15:25:56 -0500
- Subject: Re: [MTASCsft PATCH WIP5 01/33] Multi Thread, Async Signal and Async Cancel safety documentation: intro
- Authentication-results: sourceware.org; auth=none
- References: <20131113081059 dot 3464 dot 51385 dot stgit at frit dot home> <20131113081132 dot 3464 dot 30409 dot stgit at frit dot home> <Pine dot LNX dot 4 dot 64 dot 1311131256090 dot 18987 at digraph dot polyomino dot org dot uk>
On 11/13/2013 07:57 AM, Joseph S. Myers wrote:
> On Wed, 13 Nov 2013, Alexandre Oliva wrote:
>
>> +@item @code{simfpu}
>> +@cindex simfpu
>> +
>> +Functions annotated with @code{simfpu} may misbehave on powerpc ports in
>> +which the floating-point unit is disabled and floating point simulation
>
> Reviewing <https://sourceware.org/ml/libc-alpha/2013-11/msg00189.html>,
> and <https://sourceware.org/ml/libc-alpha/2013-11/msg00180.html> on which
> it depends, would be better than documenting the bug....
The adverb better should be associated with some kind of improvement
e.g. better that we have less defects instead of more detailed documentation.
While I agree that it is always better from a quality perspective to fix
bugs instead of documenting them, the problem is that Alex's goal here is
not to fix the bugs but to document several attributes for all functions
in the library.
We'll come back to the bugs. Please grant us your patience for the meantime.
Cheers,
Carlos.