From patchwork Sun Mar 31 20:38:48 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alejandro Colomar X-Patchwork-Id: 1918357 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@legolas.ozlabs.org Authentication-Results: legolas.ozlabs.org; dkim=pass (2048-bit key; unprotected) header.d=kernel.org header.i=@kernel.org header.a=rsa-sha256 header.s=k20201202 header.b=Fow+xdVl; dkim-atps=neutral Authentication-Results: legolas.ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=sourceware.org (client-ip=2620:52:3:1:0:246e:9693:128c; helo=server2.sourceware.org; envelope-from=libc-alpha-bounces+incoming=patchwork.ozlabs.org@sourceware.org; receiver=patchwork.ozlabs.org) Received: from server2.sourceware.org (server2.sourceware.org [IPv6:2620:52:3:1:0:246e:9693:128c]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (secp384r1) server-digest SHA384) (No client certificate requested) by legolas.ozlabs.org (Postfix) with ESMTPS id 4V75cq41j6z1yYB for ; Mon, 1 Apr 2024 07:40:27 +1100 (AEDT) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id C47F43858D35 for ; Sun, 31 Mar 2024 20:40:25 +0000 (GMT) X-Original-To: libc-alpha@sourceware.org Delivered-To: libc-alpha@sourceware.org Received: from sin.source.kernel.org (sin.source.kernel.org [145.40.73.55]) by sourceware.org (Postfix) with ESMTPS id 1180F385842C for ; Sun, 31 Mar 2024 20:38:55 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 1180F385842C Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=kernel.org Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=kernel.org ARC-Filter: OpenARC Filter v1.0.0 sourceware.org 1180F385842C Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=145.40.73.55 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1711917538; cv=none; b=w1M6+0zxYxh+vUJKGCnSVTdJTwQ4sRjI3ETqbfRgL57D8O5apdQK0RXPRlHYg8gfAf48qs+g743nrjbw14ajv4ekH45MCiJtF/IbuYkHaYYD3I8L8j56jNG7o8xJJTWjsjmbe9fquGeNoxq5HQ5V8EJ6qCROrJXkMJAMztignSM= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1711917538; c=relaxed/simple; bh=gKH+7BdUChhLIIMNkcrUV+TAepLNwFO9CaEY9O74ASE=; h=DKIM-Signature:Date:From:To:Subject:Message-ID:MIME-Version; b=benNwvzkmLqHT3tN8UJrfvSkn0Ig+Jw6RmhtsieDguetSlDOK7Iv0WOc1tRVieFiB4yGPWQEJlbfJNYTuJBNKdGkijiGuvDFc1GATAAtYfya5XM0nkd60w1eXzvyl2q7Fa/Apl7AefyC8sAP19FCsX2t3If2/uoiik1RLcbA4r4= ARC-Authentication-Results: i=1; server2.sourceware.org Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by sin.source.kernel.org (Postfix) with ESMTP id 830B1CE0B4B; Sun, 31 Mar 2024 20:38:52 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 14C89C433C7; Sun, 31 Mar 2024 20:38:49 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1711917531; bh=gKH+7BdUChhLIIMNkcrUV+TAepLNwFO9CaEY9O74ASE=; h=Date:From:To:Cc:Subject:References:In-Reply-To:From; b=Fow+xdVlSUBl54GZAbgQ9ft9Z+Qglwp3KojoDX1JQkV1z68OVNjmd+nn5pyZxLFX/ mBECb9IA/wwiWnxX1SNLJdIMcXSdR2zfAicYd7kCLjpRPZvABxbYSkzG1X4qzsxumx ozJpO3CM7qlbMPKgvchtLlEo40Qa9vbuoTjBKtfgy9VkFFJl6Gp0qNxtaZ8DazihoD yYFR9mdbv/uvWSxK26smNBLXSGbEFr1jE9o6Ysn7v7iavvKia8Hv1lu/kKWopCBtlp nwH0XJH4w/MUKWUidJc1y+VjStDRU1z3S/SbOJ4unE+YlWdWLrxEbQItejXBCKhoj4 V3O8pnk7c+k4g== Date: Sun, 31 Mar 2024 22:38:48 +0200 From: Alejandro Colomar To: libc-alpha@sourceware.org Cc: Alejandro Colomar , Morten Welinder , Adhemerval Zanella Netto , Vincent Lefevre , DJ Delorie , Paul Zimmermann , Andreas Schwab Subject: [PATCH v3 3/4] manual: Clarify return value of cbrt(3) Message-ID: <20240331203829.23591-4-alx@kernel.org> X-Mailer: git-send-email 2.43.0 References: <20240305161213.14364-1-alx@kernel.org> <20240331203829.23591-1-alx@kernel.org> MIME-Version: 1.0 Content-Disposition: inline In-Reply-To: <20240331203829.23591-1-alx@kernel.org> X-Spam-Status: No, score=-10.2 required=5.0 tests=BAYES_00, DKIMWL_WL_HIGH, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, GIT_PATCH_0, SPF_HELO_NONE, SPF_PASS, TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org X-BeenThere: libc-alpha@sourceware.org X-Mailman-Version: 2.1.30 Precedence: list List-Id: Libc-alpha mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: libc-alpha-bounces+incoming=patchwork.ozlabs.org@sourceware.org Link: Reported-by: Morten Welinder Cowritten-by: Morten Welinder Cc: Adhemerval Zanella Netto Cc: Vincent Lefevre Cc: DJ Delorie Cc: Paul Zimmermann Cc: Andreas Schwab Signed-off-by: Alejandro Colomar --- manual/math.texi | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/manual/math.texi b/manual/math.texi index 79bf3a1401..dfb685a71e 100644 --- a/manual/math.texi +++ b/manual/math.texi @@ -700,8 +700,12 @@ Mathematically, it should return a complex number. @standardsx{cbrtfN, TS 18661-3:2015, math.h} @standardsx{cbrtfNx, TS 18661-3:2015, math.h} @safety{@prelim{}@mtsafe{}@assafe{}@acsafe{}} -These functions return the cube root of @var{x}. They cannot -fail; every representable real value has a representable real cube root. +These functions return the cube root of @var{x}. +They cannot fail; +every representable real value +has a real cube root, +and rounding it to a representable value +never causes overflow nor underflow. @end deftypefun @deftypefun double hypot (double @var{x}, double @var{y})