From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: by sourceware.org (Postfix, from userid 2181) id AF9393858D33; Thu, 6 Jul 2023 15:44:08 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org AF9393858D33 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gcc.gnu.org; s=default; t=1688658248; bh=tOsMyyQ9uRazl/1WzJrbU3kAxVC8pTpR3fA7079eG6c=; h=From:To:Subject:Date:From; b=OAPDioiMNwwoeqWE6jJ3KWf1XuuFRU+qNJHElBR8eqFc4fiFT3FIMvCEpbgOpddi8 UH2kmbJHUm8z+lXBTEUd/9/Tt3ngYWN7ZumNIydhp6VZKjdHyv2fJ4dt5yAjF2Gd5u wbs6UhFjZR74pFoCh4hBv2g4C7s28Akcf5Ble89Y= MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset="utf-8" From: Jonathan Wakely To: gcc-cvs@gcc.gnu.org, libstdc++-cvs@gcc.gnu.org Subject: [gcc r12-9757] libstdc++: Document --enable-cstdio=stdio_pure [PR104299] X-Act-Checkin: gcc X-Git-Author: Jonathan Wakely X-Git-Refname: refs/heads/releases/gcc-12 X-Git-Oldrev: a7edbb014f8d4730395e6da0f74a993170d3bc5d X-Git-Newrev: 67bda4331dc4f548820ed2f3138aa7f64fd4c77d Message-Id: <20230706154408.AF9393858D33@sourceware.org> Date: Thu, 6 Jul 2023 15:44:08 +0000 (GMT) List-Id: https://gcc.gnu.org/g:67bda4331dc4f548820ed2f3138aa7f64fd4c77d commit r12-9757-g67bda4331dc4f548820ed2f3138aa7f64fd4c77d Author: Jonathan Wakely Date: Thu Jul 6 16:25:47 2023 +0100 libstdc++: Document --enable-cstdio=stdio_pure [PR104299] libstdc++-v3/ChangeLog: PR libstdc++/104299 * doc/xml/manual/configure.xml: Describe stdio_pure argument to --enable-cstdio. * doc/html/manual/configure.html: Regenerate. (cherry picked from commit b90a70984a9beee39b41f842b56926f9db2069ca) Diff: --- libstdc++-v3/doc/html/manual/configure.html | 11 ++++++++--- libstdc++-v3/doc/xml/manual/configure.xml | 11 ++++++++--- 2 files changed, 16 insertions(+), 6 deletions(-) diff --git a/libstdc++-v3/doc/html/manual/configure.html b/libstdc++-v3/doc/html/manual/configure.html index 31c4da8a5e3..5981c6c548b 100644 --- a/libstdc++-v3/doc/html/manual/configure.html +++ b/libstdc++-v3/doc/html/manual/configure.html @@ -38,9 +38,14 @@ 

    --with-gxx-include-dir=/foo/H-x86-gcc-3-c-gxx-inc/include/4.4-20090404
--enable-cstdio

This is an abbreviated form of '--enable-cstdio=stdio' (described next). -

--enable-cstdio=OPTION

Select a target-specific I/O package. At the moment, the only - choice is to use 'stdio', a generic "C" abstraction. - The default is 'stdio'. This option can change the library ABI. +

--enable-cstdio=OPTION

Select a target-specific I/O package. The choices are 'stdio' + which is a generic abstraction using POSIX file I/O APIs + (read, write, + lseek, etc.), and 'stdio_pure' which is similar + but only uses standard C file I/O APIs (fread, + fwrite, fseek, etc.). + The 'stdio_posix' choice is a synonym for 'stdio'. + The default is 'stdio'. This option can change the library ABI.

--enable-clocale

This is an abbreviated form of '--enable-clocale=generic' (described next).

--enable-clocale=OPTION

Select a target-specific underlying locale package. The diff --git a/libstdc++-v3/doc/xml/manual/configure.xml b/libstdc++-v3/doc/xml/manual/configure.xml index 8c26acc95a7..f01fdb9b0d4 100644 --- a/libstdc++-v3/doc/xml/manual/configure.xml +++ b/libstdc++-v3/doc/xml/manual/configure.xml @@ -74,9 +74,14 @@ --enable-cstdio=OPTION - Select a target-specific I/O package. At the moment, the only - choice is to use 'stdio', a generic "C" abstraction. - The default is 'stdio'. This option can change the library ABI. + Select a target-specific I/O package. The choices are 'stdio' + which is a generic abstraction using POSIX file I/O APIs + (read, write, + lseek, etc.), and 'stdio_pure' which is similar + but only uses standard C file I/O APIs (fread, + fwrite, fseek, etc.). + The 'stdio_posix' choice is a synonym for 'stdio'. + The default is 'stdio'. This option can change the library ABI.