From nobody Wed Nov 11 14:42:19 2026 X-Original-To: dev-commits-src-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4jPmSq6mC1z70JG5 for ; Wed, 11 Nov 2026 14:42:19 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange x25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 4jPmSq5cSZz4N4D for ; Wed, 11 Nov 2026 14:42:19 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1794408139; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=tVRuin0cr/+d33ibfuOxgFLL6WRRgVCoEBJU88NOU2A=; b=snPUfKW6aTTnFct1dkkEhuiLSjDkY4bs8PONmWmFRbfVuMvf07woQBvqVKzOwKMIaX0Vwc RNXtNpAdby7QQ+WLshywbhySDh5WMC7QdNBkz/bP9pStZVJMaVYFoalQSWfF6nJEQrLkun gQEKKJiOqQLiCd+9ODqA4Egbw9my7lBOQQNJ+7y/PNb0OYkIOcPwkaTBG6O9o4we6xGkog M5MBevpGh/zc+Lp+jP7wWgY7E9B9XIR/Jp6NHt2+dThNz6BUq26g3ePgyqUMGVzX/T8X3v R2QplVDEl+ZwLi3dL4b5wnFuMFOhCUT4ieQaleFPUhWm9MSWwc65CEopAoK3sw== ARC-Seal: i=1; a=rsa-sha256; d=freebsd.org; s=dkim; cv=none; t=1794408139; b=fHjqrqMJ9ho9U/lOzJIn5+R5pH+nzHqOQrlidR/Pqmh4VMd/DsSPLSnJMQNqkqxTJMf+jk PEQ42s03Ev1Q4V6ZqGEODqhzjF72j5vMR6nEsb9o940QK8TG73NL5HmyKZ/kkLytosyJrl T8Mc9ZCkHlYDJcBNKVeix7h+vMo8cva7XnibQPsChN5tZ3vU2QjvioEePDpXnBSmmJHKiw 9tW2yrTmB4nNcndviHnAU8tl/YSSi00EEaGU17GIAfM/lRIOxlSqRVpEhxicZOanZ+tm4Q 6+XamEdshRlUcdDhYpLyuRNrCf95Hpd0bGiAe7GgWMGMM/WSWNbJne1xVJPC5A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1794408139; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=tVRuin0cr/+d33ibfuOxgFLL6WRRgVCoEBJU88NOU2A=; b=JMuQPzwqNMR41BmyZi3WYPJstP97CxUmpfkwLfhgR6ue+NjDa9TF/P79dZ2iBU27UHZQ4z H4w3gWnt1GsC/Jq7N4VwTcA/tCHFL53Xm0kOClT0dZixQKsp4ugYsVwdtzDneLwIWYVU7U Ugx2UHy17oCMUFlewxIu0o9Zx7808LkiFidmlmYSpYdOw5Bu7u3WCqTpHukd0GCT/ycCbj Q/h6TGfIN8LRGiQ/WCMF8691tjrwRKWmciHxBQsI+wuOz3HGPAdPswv/uNZYm4jOC0VKLf 2IEnC7seHCb8FBUk2aM6T9Exa39UPcfpcDTfpuoNY8xebmSAtVKOxfzthXZ6tg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4jPmSq5GwbzHjT for ; Wed, 11 Nov 2026 14:42:19 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id f2f5 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Wed, 11 Nov 2026 14:42:19 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Aymeric Wibo Subject: git: 7b5a98c20223 - main - libc: Refer to xlocale(3) in strto*/wcsto* manpages List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all X-BeenThere: dev-commits-src-all@freebsd.org List-Id: Commit messages for all branches of the src repository List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: obiwac X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 7b5a98c202238b7c2dcbc720d064e28d13702527 Auto-Submitted: auto-generated Date: Wed, 11 Nov 2026 14:42:19 +0000 Message-Id: <6af47ecb.f2f5.572142ab@gitrepo.freebsd.org> The branch main has been updated by obiwac: URL: https://cgit.FreeBSD.org/src/commit/?id=7b5a98c202238b7c2dcbc720d064e28d13702527 commit 7b5a98c202238b7c2dcbc720d064e28d13702527 Author: Aymeric Wibo AuthorDate: 2026-11-11 14:35:56 +0000 Commit: Aymeric Wibo CommitDate: 2026-11-11 14:42:12 +0000 libc: Refer to xlocale(3) in strto*/wcsto* manpages Mention the extended locale (_l) versions of strtol(3), strtoul(3), strtod(3), wcstol(3), and wcstod(3) and point to xlocale(3). While here, add missing serial commas in function lists and widen the strtol(3) RETURN VALUES table columns to fit INTMAX_MIN/INTMAX_MAX. Obtained from: https://github.com/apple-oss-distributions/libc (partially) Sponsored by: Klara, Inc. --- lib/libc/locale/wcstod.3 | 9 ++++++--- lib/libc/locale/wcstol.3 | 11 +++++++---- lib/libc/stdlib/strtod.3 | 9 +++++---- lib/libc/stdlib/strtol.3 | 14 +++++++++++--- lib/libc/stdlib/strtoul.3 | 12 ++++++++++-- 5 files changed, 39 insertions(+), 16 deletions(-) diff --git a/lib/libc/locale/wcstod.3 b/lib/libc/locale/wcstod.3 index 15af283fdd06..c480047dd984 100644 --- a/lib/libc/locale/wcstod.3 +++ b/lib/libc/locale/wcstod.3 @@ -22,7 +22,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd February 22, 2003 +.Dd November 11, 2026 .Dt WCSTOD 3 .Os .Sh NAME @@ -46,18 +46,21 @@ or .Sh DESCRIPTION The .Fn wcstof , -.Fn wcstod +.Fn wcstod , and .Fn wcstold functions are the wide-character versions of the .Fn strtof , -.Fn strtod +.Fn strtod , and .Fn strtold functions. Refer to .Xr strtod 3 for details. +.Pp +Extended locale versions of these functions are documented in +.Xr xlocale 3 . .Sh SEE ALSO .Xr strtod 3 , .Xr wcstol 3 diff --git a/lib/libc/locale/wcstol.3 b/lib/libc/locale/wcstol.3 index 725473cebb66..adee7d452b1b 100644 --- a/lib/libc/locale/wcstol.3 +++ b/lib/libc/locale/wcstol.3 @@ -22,7 +22,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd September 7, 2002 +.Dd November 11, 2026 .Dt WCSTOL 3 .Os .Sh NAME @@ -61,7 +61,7 @@ The .Fn wcstoul , .Fn wcstoll , .Fn wcstoull , -.Fn wcstoimax +.Fn wcstoimax , and .Fn wcstoumax functions are wide-character versions of the @@ -69,13 +69,16 @@ functions are wide-character versions of the .Fn strtoul , .Fn strtoll , .Fn strtoull , -.Fn strtoimax +.Fn strtoimax , and .Fn strtoumax functions, respectively. Refer to their manual pages (for example .Xr strtol 3 ) for details. +.Pp +Extended locale versions of these functions are documented in +.Xr xlocale 3 . .Sh SEE ALSO .Xr strtol 3 , .Xr strtoul 3 @@ -85,7 +88,7 @@ The .Fn wcstoul , .Fn wcstoll , .Fn wcstoull , -.Fn wcstoimax +.Fn wcstoimax , and .Fn wcstoumax functions conform to diff --git a/lib/libc/stdlib/strtod.3 b/lib/libc/stdlib/strtod.3 index 018e1e8c3c38..74e2a8bbba0b 100644 --- a/lib/libc/stdlib/strtod.3 +++ b/lib/libc/stdlib/strtod.3 @@ -29,14 +29,12 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd May 11, 2010 +.Dd November 11, 2026 .Dt STRTOD 3 .Os .Sh NAME .Nm strtod , strtof , strtold -.Nd convert -.Tn ASCII -string to floating point +.Nd convert ASCII string to floating point .Sh LIBRARY .Lb libc .Sh SYNOPSIS @@ -113,6 +111,9 @@ function) are skipped. The decimal point character is defined in the program's locale (category .Dv LC_NUMERIC ) . +.Pp +Extended locale versions of these functions are documented in +.Xr xlocale 3 . .Sh RETURN VALUES The .Fn strtod , diff --git a/lib/libc/stdlib/strtol.3 b/lib/libc/stdlib/strtol.3 index af8bec579dbf..4a148ad63a51 100644 --- a/lib/libc/stdlib/strtol.3 +++ b/lib/libc/stdlib/strtol.3 @@ -29,7 +29,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd August 21, 2023 +.Dd November 11, 2026 .Dt STRTOL 3 .Os .Sh NAME @@ -154,11 +154,19 @@ but is .Ql \e0 on return, the entire string was valid.) +.Pp +Extended locale versions of the +.Fn strtol , +.Fn strtoll , +and +.Fn strtoimax +functions are documented in +.Xr xlocale 3 . .Sh RETURN VALUES The .Fn strtol , .Fn strtoll , -.Fn strtoimax +.Fn strtoimax , and .Fn strtoq functions @@ -176,7 +184,7 @@ is set to .Er ERANGE and the function return value is clamped according to the following table. -.Bl -column -offset indent ".Fn strtoimax" ".Sy underflow" ".Sy overflow" +.Bl -column -offset indent ".Fn strtoimax" ".Dv INTMAX_MIN" ".Dv INTMAX_MAX" .It Sy Function Ta Sy underflow Ta Sy overflow .It Fn strtol Ta Dv LONG_MIN Ta Dv LONG_MAX .It Fn strtoll Ta Dv LLONG_MIN Ta Dv LLONG_MAX diff --git a/lib/libc/stdlib/strtoul.3 b/lib/libc/stdlib/strtoul.3 index 3e4b6bdc20fb..b418f29ea0e0 100644 --- a/lib/libc/stdlib/strtoul.3 +++ b/lib/libc/stdlib/strtoul.3 @@ -29,7 +29,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.Dd August 21, 2023 +.Dd November 11, 2026 .Dt STRTOUL 3 .Os .Sh NAME @@ -153,11 +153,19 @@ but is .Ql \e0 on return, the entire string was valid.) +.Pp +Extended locale versions of the +.Fn strtoul , +.Fn strtoull , +and +.Fn strtoumax +functions are documented in +.Xr xlocale 3 . .Sh RETURN VALUES The .Fn strtoul , .Fn strtoull , -.Fn strtoumax +.Fn strtoumax , and .Fn strtouq functions