From mboxrd@z Thu Jan 1 00:00:00 1970
Return-Path:
Received: by sourceware.org (Postfix, from userid 2181)
id 185D43858C2D; Thu, 6 Jul 2023 15:39:47 +0000 (GMT)
DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 185D43858C2D
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gcc.gnu.org;
s=default; t=1688657987;
bh=5fyqOi7yLvO8bhl5ihrpzoKFTtwFmKcHqWwj0UqirCw=;
h=From:To:Subject:Date:From;
b=YE+HJX84SukX19GEVCehf6VmhJrQz3H6Fkvx1I+8nxdn4nXY9jLCqRibrGmKE1NHu
FAs3+6frET95bgG80Ji0qnDq7JHUSRgaMMNNHVmgAQq27uTEd3yrwMnXTfNqtGylK6
WqbfHpvXRC2WKlcKlu7IKPaQY6Q0CD7DnTgThO2U=
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 r13-7537] libstdc++: Document --enable-cstdio=stdio_pure
[PR104299]
X-Act-Checkin: gcc
X-Git-Author: Jonathan Wakely
X-Git-Refname: refs/heads/releases/gcc-13
X-Git-Oldrev: 41d940c0c459e599a71bdfc72d62a6d836b225cb
X-Git-Newrev: 94d24f1af684d37b9e1c6ad9b54c98609140eb1f
Message-Id: <20230706153947.185D43858C2D@sourceware.org>
Date: Thu, 6 Jul 2023 15:39:47 +0000 (GMT)
List-Id:
https://gcc.gnu.org/g:94d24f1af684d37b9e1c6ad9b54c98609140eb1f
commit r13-7537-g94d24f1af684d37b9e1c6ad9b54c98609140eb1f
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 dd9e6ef3579..c81e5993b08 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 7ff07aea886..1b8c37ce2a9 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.