This is the mail archive of the gcc-patches@gcc.gnu.org mailing list for the GCC project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

[PATCH] extend.texi update for decimal floating types


This patch updates information in the GCC Manual about support for
decimal floating types by referencing the latest draft of the Technical
Report and mentioning the parts of that TR that GCC does not support.
It also uses terminology from the TR.

This is not quite true, since the patch to disallow mixed-mode
arithmetic between decimal floating types and generic floating types
(float, double, long double) has not yet been approved.  Rather than
mention that difference from the draft TR, I'd rather ping, once again,
that patch that will bring GCC in line with the latest draft TR.  That
patch is at

  http://gcc.gnu.org/ml/gcc-patches/2006-01/msg01761.html

I haven't tested it recently but will do that when it's approved and
before checking it in.  Is it OK for mainline?

This doc patch was tested using "make info" and "make dvi" (after
removing reference to srcdir in extend.texi, which breaks "make dvi" in
my environment) on powerpc64-linux.  OK for mainline?

2006-03-15  Janis Johnson  <janis187@us.ibm.com>

	* doc/extend.texi (Decimal Float): Reference latest draft TR,
	use terminology that matches TR.

Index: gcc/doc/extend.texi
===================================================================
--- gcc/doc/extend.texi	(revision 111848)
+++ gcc/doc/extend.texi	(working copy)
@@ -33,7 +33,7 @@
 * Conditionals::        Omitting the middle operand of a @samp{?:} expression.
 * Long Long::		Double-word integers---@code{long long int}.
 * Complex::             Data types for complex numbers.
-* Decimal Float::	Decimal Floating Point. 
+* Decimal Float::	Decimal Floating Types. 
 * Hex Floats::          Hexadecimal floating-point constants.
 * Zero Length::         Zero-length arrays.
 * Variable Length::     Arrays whose length is computed at run time.
@@ -816,8 +816,8 @@
 examine and set these two fictitious variables with your debugger.
 
 @node Decimal Float
-@section Decimal Floating Point
-@cindex decimal floating point
+@section Decimal Floating Types
+@cindex decimal floating types
 @cindex @code{_Decimal32} data type
 @cindex @code{_Decimal64} data type
 @cindex @code{_Decimal128} data type
@@ -828,24 +828,22 @@
 @cindex @code{DD} integer suffix
 @cindex @code{DL} integer suffix
 
-GNU C supports decimal floating point types in addition to the
-standard floating-point types.  This extension supports decimal
-floating-point arithmetic as defined in IEEE-754R, the proposed
-revision of IEEE-754.  The C language extension is defined in ISO/IEC
-DTR 24732, Draft 5.  Support for this functionality will change when
-it is accepted into the C standard and might change for new drafts
-of the proposal.  Calling conventions for any target might also change.
-Not all targets support decimal floating point.
+GNU C supports decimal floating types as defined in the N1154 draft
+of ISO/IEC TR24732, except that the @code{DEC_MAX_PRECISION} pragma
+and translation time data type (TTDT) are not supported.
+Support for decimal floating types will change as the draft TR changes.
+Calling conventions for any target might also change.  Not all targets
+support decimal floating types.
 
-Support for decimal floating point includes the arithmetic operators
+Support for decimal floating types includes the arithmetic operators
 add, subtract, multiply, divide; unary arithmetic operators;
 relational operators; equality operators; and conversions to and from
-integer and other floating-point types.  Use a suffix @samp{df} or
+integer and other floating types.  Use a suffix @samp{df} or
 @samp{DF} in a literal constant of type @code{_Decimal32}, @samp{dd}
 or @samp{DD} for @code{_Decimal64}, and @samp{dl} or @samp{DL} for
 @code{_Decimal128}.
 
-Passing a decimal floating-point value as an argument to a function
+Passing a decimal floating type value as an argument to a function
 without a prototype is undefined.
 
 Types @code{_Decimal32}, @code{_Decimal64}, and @code{_Decimal128}


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]