From patchwork Wed Jun 21 17:45:21 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Gabriel F. T. Gomes" X-Patchwork-Id: 779037 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from sourceware.org (server1.sourceware.org [209.132.180.131]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 3wtBwS4k8Lz9s4q for ; Thu, 22 Jun 2017 03:46:32 +1000 (AEST) Authentication-Results: ozlabs.org; dkim=pass (1024-bit key; secure) header.d=sourceware.org header.i=@sourceware.org header.b="e/sQDbwW"; dkim-atps=neutral DomainKey-Signature: a=rsa-sha1; c=nofws; d=sourceware.org; h=list-id :list-unsubscribe:list-subscribe:list-archive:list-post :list-help:sender:from:to:subject:date:in-reply-to:references :message-id; q=dns; s=default; b=jE91go226ff6nbyIdjGodiqdDZJxycR nk1HHByzq1m3nP8rnY+xgTCXXbkTfaWSsQ+ubv1H91q2inRnnRn0NzzM33BEXhr5 KuYgWWa1Apu2g8mr6uKw1lt6eF8ynhwLmAV17B8mxtylG+DMJ/Z5hD+dZ/JKi0LH OzQpsIrFM8ZE= DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=sourceware.org; h=list-id :list-unsubscribe:list-subscribe:list-archive:list-post :list-help:sender:from:to:subject:date:in-reply-to:references :message-id; s=default; bh=jrUxHE+PcLPzpqMPxyvq1RWyFvo=; b=e/sQD bwW90Un/fpnLOxqegf82FdwDpGwBAh8dPjphYWM9jpjZvvwzureexeHf5IKJOGxc khHDjUmZUwACuzggLANS5KCyInjRgLeLEqepAFoXSWjj9oAigb8li7rAjmkdiJfD OIJPbky7cGRjF2iVhirJCrU9CACjqUud3fa0G8= Received: (qmail 48045 invoked by alias); 21 Jun 2017 17:46:19 -0000 Mailing-List: contact libc-alpha-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Unsubscribe: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: libc-alpha-owner@sourceware.org Delivered-To: mailing list libc-alpha@sourceware.org Received: (qmail 46493 invoked by uid 89); 21 Jun 2017 17:45:53 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-23.9 required=5.0 tests=AWL, BAYES_00, GIT_PATCH_0, GIT_PATCH_1, GIT_PATCH_2, GIT_PATCH_3, KAM_LAZY_DOMAIN_SECURITY, KHOP_DYNAMIC, RCVD_IN_DNSWL_LOW autolearn=ham version=3.3.2 spammy=0.4, magnitude X-HELO: mx0a-001b2d01.pphosted.com From: "Gabriel F. T. Gomes" To: libc-alpha@sourceware.org Subject: [PATCH v2 2/6] Describe remainder as primary and drem as alternative in the manual Date: Wed, 21 Jun 2017 14:45:21 -0300 In-Reply-To: <1498067125-30472-1-git-send-email-gftg@linux.vnet.ibm.com> References: <1498067125-30472-1-git-send-email-gftg@linux.vnet.ibm.com> X-TM-AS-MML: disable x-cbid: 17062117-0020-0000-0000-000002B7AF7C X-IBM-AV-DETECTION: SAVI=unused REMOTE=unused XFE=unused x-cbparentid: 17062117-0021-0000-0000-000030D6D610 Message-Id: <1498067125-30472-3-git-send-email-gftg@linux.vnet.ibm.com> X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10432:, , definitions=2017-06-21_04:, , signatures=0 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 spamscore=0 suspectscore=1 malwarescore=0 phishscore=0 adultscore=0 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1703280000 definitions=main-1706210298 New since v1. -- 8< -- In preparation for the documentation of _FloatN and _FloatNx variants of the remainder function, this patch changes the descriptions of remainder and drem, so that remainder is described as primary and drem as an alternative name for the same functionality. * manual/arith.texi (Remainder Functions): Describe remainder as primary and drem as an alternative name. Change the comment on remainder to ISO, since it is defined in ISO C99. --- manual/arith.texi | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff --git a/manual/arith.texi b/manual/arith.texi index dd6020c..e403cb5 100644 --- a/manual/arith.texi +++ b/manual/arith.texi @@ -1591,31 +1591,31 @@ less than the magnitude of the @var{denominator}. If @var{denominator} is zero, @code{fmod} signals a domain error. @end deftypefun -@deftypefun double drem (double @var{numerator}, double @var{denominator}) -@deftypefunx float dremf (float @var{numerator}, float @var{denominator}) -@deftypefunx {long double} dreml (long double @var{numerator}, long double @var{denominator}) -@standards{BSD, math.h} +@deftypefun double remainder (double @var{numerator}, double @var{denominator}) +@deftypefunx float remainderf (float @var{numerator}, float @var{denominator}) +@deftypefunx {long double} remainderl (long double @var{numerator}, long double @var{denominator}) +@standards{ISO, math.h} @safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}} These functions are like @code{fmod} except that they round the internal quotient @var{n} to the nearest integer instead of towards zero -to an integer. For example, @code{drem (6.5, 2.3)} returns @code{-0.4}, -which is @code{6.5} minus @code{6.9}. +to an integer. For example, @code{remainder (6.5, 2.3)} returns +@code{-0.4}, which is @code{6.5} minus @code{6.9}. The absolute value of the result is less than or equal to half the absolute value of the @var{denominator}. The difference between -@code{fmod (@var{numerator}, @var{denominator})} and @code{drem +@code{fmod (@var{numerator}, @var{denominator})} and @code{remainder (@var{numerator}, @var{denominator})} is always either @var{denominator}, minus @var{denominator}, or zero. -If @var{denominator} is zero, @code{drem} signals a domain error. +If @var{denominator} is zero, @code{remainder} signals a domain error. @end deftypefun -@deftypefun double remainder (double @var{numerator}, double @var{denominator}) -@deftypefunx float remainderf (float @var{numerator}, float @var{denominator}) -@deftypefunx {long double} remainderl (long double @var{numerator}, long double @var{denominator}) +@deftypefun double drem (double @var{numerator}, double @var{denominator}) +@deftypefunx float dremf (float @var{numerator}, float @var{denominator}) +@deftypefunx {long double} dreml (long double @var{numerator}, long double @var{denominator}) @standards{BSD, math.h} @safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}} -This function is another name for @code{drem}. +This function is another name for @code{remainder}. @end deftypefun @node FP Bit Twiddling