This is the mail archive of the
libc-alpha@sourceware.org
mailing list for the glibc project.
Re: [PATCH] Add nextup and nextdown math functions
- From: Joseph Myers <joseph at codesourcery dot com>
- To: Rical Jasan <ricaljasan at pacific dot net>
- Cc: Rajalakshmi Srinivasaraghavan <raji at linux dot vnet dot ibm dot com>, <libc-alpha at sourceware dot org>
- Date: Thu, 2 Jun 2016 23:32:01 +0000
- Subject: Re: [PATCH] Add nextup and nextdown math functions
- Authentication-results: sourceware.org; auth=none
- References: <201606011211 dot u51C9sVN019582 at mx0a-001b2d01 dot pphosted dot com> <574FE5C6 dot 6040303 at pacific dot net>
On Thu, 2 Jun 2016, Rical Jasan wrote:
> I can't recall ever seeing a function call within a paragraph, and
> haven't been able to find an example, skimming through the manual. I
> suggest using a similar style to what you've already used (i.e., "If
> @var{x} is @code{-HUGE_VAL}, the return value is @code{-HUGE_VAL}.") or
> breaking it out into a @smallexample and rearranging/rewording as necessary.
The basic problem with the documentation in the patch is that it's too
closely based on the text from the standard. It needs to be rewritten
from scratch without being based on the text from the TS.
--
Joseph S. Myers
joseph@codesourcery.com