From febe438365558c4728ec2cb22103486ea7a89b5c Mon Sep 17 00:00:00 2001 From: Thiago Jung Bauermann Date: Mon, 7 Jan 2008 22:35:36 +0000 Subject: [PATCH] * gdb.texinfo (C and C++): Add Decimal Floating Point format subsubsection. (Decimal Floating Point format): New subsubsection. --- gdb/doc/ChangeLog | 6 ++++++ gdb/doc/gdb.texinfo | 23 +++++++++++++++++++++++ 2 files changed, 29 insertions(+) diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 0d73a27980d..f1ca784d70a 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,9 @@ +2008-01-07 Thiago Jung Bauermann + + * gdb.texinfo (C and C++): Add Decimal Floating Point format + subsubsection. + (Decimal Floating Point format): New subsubsection. + 2008-01-05 Pedro Alves * gdb.texinfo (File Options): Remove mention of the attempt to diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 808b67531ac..da05dcc701f 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -9136,6 +9136,7 @@ gcc.info, Using the @sc{gnu} Compiler Collection (GCC)}. * C Checks:: C and C@t{++} type and range checks * Debugging C:: @value{GDBN} and C * Debugging C Plus Plus:: @value{GDBN} features for C@t{++} +* Decimal Floating Point:: Numbers in Decimal Floating Point format @end menu @node C Operators @@ -9604,6 +9605,28 @@ available choices, or to finish the type list for you. @xref{Completion,, Command Completion}, for details on how to do this. @end table +@node Decimal Floating Point +@subsubsection Decimal Floating Point format +@cindex decimal floating point format + +@value{GDBN} can examine, set and perform computations with numbers in +decimal floating point format, which in the C language correspond to the +@code{_Decimal32}, @code{_Decimal64} and @code{_Decimal128} types as +specified by the extension to support decimal floating-point arithmetic. + +There are two encodings in use, depending on the architecture: BID (Binary +Integer Decimal) for x86 and x86-64, and DPD (Densely Packed Decimal) for +PowerPC. @value{GDBN} will use the appropriate encoding for the configured +target. + +Because of a limitation in @file{libdecnumber}, the library used by @value{GDBN} +to manipulate decimal floating point numbers, it is not possible to convert +(using a cast, for example) integers wider than 32-bit to decimal float. + +In addition, in order to imitate @value{GDBN}'s behaviour with binary floating +point computations, error checking in decimal float operations ignores +underflow, overflow and divide by zero exceptions. + @node Objective-C @subsection Objective-C -- 2.30.2