This is the mail archive of the libc-alpha@sourceware.org mailing list for the glibc project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: [PATCH] Add nextup and nextdown math functions


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


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]