From mboxrd@z Thu Jan 1 00:00:00 1970
Return-Path:
Received: by sourceware.org (Postfix, from userid 2181)
id C4F773858C74; Thu, 6 Jul 2023 15:28:01 +0000 (GMT)
DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org C4F773858C74
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gcc.gnu.org;
s=default; t=1688657281;
bh=ONUElYQ0hm18+oHwY9id59sPwUBJTky9vIPAlZ0kVIs=;
h=From:To:Subject:Date:From;
b=s0jLf6jnnPryFT8B2EB9wrOKD7peMxjGSHB+C8ZfbA0O35jzdm2OhI2rSX26xTbMh
eZRxWkJgsT4iGWZyr4Of9j0lSV5XQNn9FDULi98d5NhsYP4ekDm5d+yLJf3Y7otK+c
OeFdZi14snEGJiqZTERSiEbjKHhHZ8FUlZONkbpE=
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 r14-2366] libstdc++: Document --enable-cstdio=stdio_pure
[PR110574]
X-Act-Checkin: gcc
X-Git-Author: Jonathan Wakely
X-Git-Refname: refs/heads/master
X-Git-Oldrev: 2e406f0753e8d78d320437189211e3094c33b7e4
X-Git-Newrev: b90a70984a9beee39b41f842b56926f9db2069ca
Message-Id: <20230706152801.C4F773858C74@sourceware.org>
Date: Thu, 6 Jul 2023 15:28:01 +0000 (GMT)
List-Id:
https://gcc.gnu.org/g:b90a70984a9beee39b41f842b56926f9db2069ca
commit r14-2366-gb90a70984a9beee39b41f842b56926f9db2069ca
Author: Jonathan Wakely
Date: Thu Jul 6 16:25:47 2023 +0100
libstdc++: Document --enable-cstdio=stdio_pure [PR110574]
libstdc++-v3/ChangeLog:
PR libstdc++/110574
* doc/xml/manual/configure.xml: Describe stdio_pure argument to
--enable-cstdio.
* doc/html/manual/configure.html: Regenerate.
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.