From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: by sourceware.org (Postfix, from userid 2181) id E93D23858CDB; Sat, 5 Nov 2022 12:38:05 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org E93D23858CDB DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gcc.gnu.org; s=default; t=1667651885; bh=KALINe35tOBzJN6gvDTHKaafWQSfU9bsf2Dfmpg6stw=; h=From:To:Subject:Date:From; b=fdC7Qp3vrhuGrmdphcFWswG6rBK+eTyMo5A5me/pG8m0mVhljQ++CafVCl/iLyJ2m pWK/VaW8wlZuZzcFsypxn6IwH8XDKbh0jsj2zctBUzfdcBi9KvG5YBLMZ8Aa4tkyYP Mzn7Mpz8kl8zKgOcF18zY8Jjqj5UtuBZv8cQTAWo= MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset="utf-8" From: Jonathan Wakely To: gcc-cvs@gcc.gnu.org Subject: [gcc r12-8893] doc: Document correct -fwide-exec-charset defaults [PR41041] X-Act-Checkin: gcc X-Git-Author: Jonathan Wakely X-Git-Refname: refs/heads/releases/gcc-12 X-Git-Oldrev: 33561e870dc48966e8c7ede46e95032279a15423 X-Git-Newrev: 1342c7f46e6e3f8f29d7971531a0af18cd8429bc Message-Id: <20221105123805.E93D23858CDB@sourceware.org> Date: Sat, 5 Nov 2022 12:38:05 +0000 (GMT) List-Id: https://gcc.gnu.org/g:1342c7f46e6e3f8f29d7971531a0af18cd8429bc commit r12-8893-g1342c7f46e6e3f8f29d7971531a0af18cd8429bc Author: Jonathan Wakely Date: Fri Nov 4 12:10:32 2022 +0000 doc: Document correct -fwide-exec-charset defaults [PR41041] As shown in the PR, the default is not UTF-32 but rather UTF-32BE or UTF-32LE, avoiding the need for a byte order mark in literals. gcc/ChangeLog: PR c/41041 * doc/cppopts.texi: Document -fwide-exec-charset defaults correctly. (cherry picked from commit e50ea3a42f058c14ee29327d5277ab0435e3d36b) Diff: --- gcc/doc/cppopts.texi | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/gcc/doc/cppopts.texi b/gcc/doc/cppopts.texi index 75c56a368ca..c0a92b37018 100644 --- a/gcc/doc/cppopts.texi +++ b/gcc/doc/cppopts.texi @@ -318,9 +318,10 @@ supported by the system's @code{iconv} library routine. @opindex fwide-exec-charset @cindex character set, wide execution Set the wide execution character set, used for wide string and -character constants. The default is UTF-32 or UTF-16, whichever -corresponds to the width of @code{wchar_t}. As with -@option{-fexec-charset}, @var{charset} can be any encoding supported +character constants. The default is one of UTF-32BE, UTF-32LE, UTF-16BE, +or UTF-16LE, whichever corresponds to the width of @code{wchar_t} and the +big-endian or little-endian byte order being used for code generation. As +with @option{-fexec-charset}, @var{charset} can be any encoding supported by the system's @code{iconv} library routine; however, you will have problems with encodings that do not fit exactly in @code{wchar_t}.