This is the mail archive of the
libc-alpha@sourceware.org
mailing list for the glibc project.
Re: Consensus on MT-, AS- and AC-Safety docs.
- From: "Joseph S. Myers" <joseph at codesourcery dot com>
- To: Alexandre Oliva <aoliva at redhat dot com>
- Cc: Carlos O'Donell <carlos at redhat dot com>, GNU C Library <libc-alpha at sourceware dot org>, Rich Felker <dalias at aerifal dot cx>, Torvald Riegel <triegel at redhat dot com>
- Date: Fri, 22 Nov 2013 13:33:41 +0000
- Subject: Re: Consensus on MT-, AS- and AC-Safety docs.
- Authentication-results: sourceware.org; auth=none
- References: <528A7C8F dot 8060805 at redhat dot com> <Pine dot LNX dot 4 dot 64 dot 1311182312130 dot 8831 at digraph dot polyomino dot org dot uk> <528BA2DA dot 3090608 at redhat dot com> <Pine dot LNX dot 4 dot 64 dot 1311192205550 dot 8742 at digraph dot polyomino dot org dot uk> <ortxf6tcpk dot fsf at livre dot home> <Pine dot LNX dot 4 dot 64 dot 1311211304050 dot 14539 at digraph dot polyomino dot org dot uk> <orzjoxro50 dot fsf at livre dot home>
On Fri, 22 Nov 2013, Alexandre Oliva wrote:
> > I prefer longer, more readable names (e.g. floating-point-environment).
>
> But that's meaningless. Well, yeah, I understand
It names the state used by the function.
> We actually have good, settled precedent in using non-English keywords
> in error codes that may be stored in errno.
"I would have spelled creat with an 'e'.". Overly short existing names
aren't really a good example to follow....
> potential of stream uses et al in there. If I had to guess (and I do
> :-) I'd say it was because I remember that this was all deprecated (I
> vaguely recall reading some email about that not too long ago), or I
> mistook _LIB_VERSION as a constant and from that misconcluded the code
> in question would have been optimized away or never executed (I can't
> rule out this possibility).
>
> Anyway... What now? Should the manual even mention this caveat when it
> doesn't seem to document the deprecated feature at all?
While I'd quite like to deprecate this functionality and even get the
_LIB_VERSION checks completely out of the runtime code paths for normal
calls to libm functions from new binaries, the manual does document
matherr:
@findex matherr
In the System V math library, the user-defined function @code{matherr}
is called when certain exceptions occur inside math library functions.
However, the Unix98 standard deprecates this interface. We support it
for historical compatibility, but recommend that you do not use it in
new programs.
It just doesn't mention the need to set _LIB_VERSION (the matherr manpage
does mention that). (There's a single testcase for this,
math/test-matherr.c.)
--
Joseph S. Myers
joseph@codesourcery.com