2003-03-15 Aldy Hernandez <aldyh@redhat.com>

	    Zack Weinberg  <zack@codesourcery.com>

	* Makefile.in (TEXI_GCCINT_FILES): Add libgcc.texi.
	* doc/libgcc.texi: New file.
	* doc/interface.texi: Delete paragraph about libgcc interface.
	* doc/gccint.texi: Add libgcc menu entry and @include libgcc.texi.


git-svn-id: svn+ssh://gcc.gnu.org/svn/gcc/trunk@64416 138bc75d-0d04-0410-961f-82ee72b054a4

4 files changed, 418 insertions, 57 deletions

diff --git a/gcc/ChangeLog b/gcc/ChangeLog
index 447cf7b9729..3ef637f2743 100644
--- a/gcc/ChangeLog
+++ b/gcc/ChangeLog
@@ -1,3 +1,11 @@
+2003-03-15  Aldy Hernandez <aldyh@redhat.com>
+	    Zack Weinberg  <zack@codesourcery.com>
+
+	* Makefile.in (TEXI_GCCINT_FILES): Add libgcc.texi.
+	* doc/libgcc.texi: New file.
+	* doc/interface.texi: Delete paragraph about libgcc interface.
+	* doc/gccint.texi: Add libgcc menu entry and @include libgcc.texi.
+
 2003-03-15  Jason Merrill  <jason@redhat.com>
 
 	PR debug/9039
@@ -231,15 +239,15 @@ Thu Mar 13 18:39:42 CET 2003  Jan Hubicka  <jh@suse.cz>
 
 2003-03-13  Aldy Hernandez  <aldyh@redhat.com>
 
-        * config/rs6000/rs6000.c (rs6000_dwarf_register_span):
-        Differentiate endianness.
-        (s6000_override_options): Use cpu type instead of TARGET_SPE.
+	* config/rs6000/rs6000.c (rs6000_dwarf_register_span):
+	Differentiate endianness.
+	(s6000_override_options): Use cpu type instead of TARGET_SPE.
 
 2003-03-13  Nick Clifton  <nickc@redhat.com>
 
 	* config/arm/arm.c (print_multi_reg): Do not generate a type 2
-        LDM instructions with writeback enabled.
-        (output_return_instruction): Likewise.
+	LDM instructions with writeback enabled.
+	(output_return_instruction): Likewise.
 
 	* config/arm/pe.h (FIXED_REGISTERS): Remove definition.
 	(CALL_USED_REGISTERS): Remove definition.
@@ -372,9 +380,9 @@ Thu Mar 13 18:39:42 CET 2003  Jan Hubicka  <jh@suse.cz>
 
 2003-03-12  Bob Wilson  <bob.wilson@acm.org>
 
-        * config/xtensa/xtensa.md (adddi3): Don't clobber source operand used
+	* config/xtensa/xtensa.md (adddi3): Don't clobber source operand used
 	to detect carry.
-        (subdi3): Reorder emitted instructions.
+	(subdi3): Reorder emitted instructions.
 
 2003-03-12  Andreas Jaeger  <aj@suse.de>
 
@@ -390,22 +398,22 @@ Thu Mar 13 18:39:42 CET 2003  Jan Hubicka  <jh@suse.cz>
 
 2003-03-12  Andreas Jaeger  <aj@suse.de>
 
-        * c-cppbuiltin.c (cb_register_builtins): Define LP64 builtins for
-        LP64 targets.
+	* c-cppbuiltin.c (cb_register_builtins): Define LP64 builtins for
+	LP64 targets.
 
-        * doc/cpp.texi (Common Predefined Macros): Document __LP64__ and
-        _LP64.
+	* doc/cpp.texi (Common Predefined Macros): Document __LP64__ and
+	_LP64.
 
-        * config/ia64/ia64.h (TARGET_CPU_CPP_BUILTINS): Do not define
-        _LP64 macros here.
-        * config/pa/pa.h (TARGET_CPU_CPP_BUILTINS): Likewise.
+	* config/ia64/ia64.h (TARGET_CPU_CPP_BUILTINS): Do not define
+	_LP64 macros here.
+	* config/pa/pa.h (TARGET_CPU_CPP_BUILTINS): Likewise.
 
-        * config/alpha/netbsd.h (TARGET_OS_CPP_BUILTINS): Remove call to
-        NETBSD_OS_CPP_BUILTINS_LP64.
-        * config/sh/netbsd-elf.h (TARGET_OS_CPP_BUILTINS): Likewise.
-        * config/sparc/netbsd-elf.h (TARGET_OS_CPP_BUILTINS): Likewise.
+	* config/alpha/netbsd.h (TARGET_OS_CPP_BUILTINS): Remove call to
+	NETBSD_OS_CPP_BUILTINS_LP64.
+	* config/sh/netbsd-elf.h (TARGET_OS_CPP_BUILTINS): Likewise.
+	* config/sparc/netbsd-elf.h (TARGET_OS_CPP_BUILTINS): Likewise.
 
-        * config/netbsd.h (NETBSD_OS_CPP_BUILTINS_LP64): Remove.
+	* config/netbsd.h (NETBSD_OS_CPP_BUILTINS_LP64): Remove.
 
 Wed Mar 12 19:04:39 CET 2003  Jan Hubicka  <jh@suse.cz>
 
@@ -466,7 +474,7 @@ Wed Mar 12 16:30:25 2003  J"orn Rennecke <joern.rennecke@superh.com>
 	DLL_IMPORT_EXPORT_PREFIX and "i."
 	(i386_pe_dllexport_name_p): Here.
 	(i386_pe_dllimport_name_p): Here.
-        (i386_pe_mark_dllexport): Here. Remove DLL_IMPORT_PREFIX,
+	(i386_pe_mark_dllexport): Here. Remove DLL_IMPORT_PREFIX,
 	not 9 chars when getting identifier name.
 	(i386_pe_mark_dllimport): Here.
 	(i386_pe_encode_section_info): Here. Remove DLL_IMPORT_PREFIX,
@@ -510,10 +518,10 @@ Wed Mar 12 16:30:25 2003  J"orn Rennecke <joern.rennecke@superh.com>
 
 2003-03-11  Aldy Hernandez  <aldyh@redhat.com>
 
-        * config/rs6000/rs6000.c (rs6000_stack_info): Remove
-        insn_chain_scanned.  Use insn_chain_scanned_p in machine_function.
+	* config/rs6000/rs6000.c (rs6000_stack_info): Remove
+	insn_chain_scanned.  Use insn_chain_scanned_p in machine_function.
 
-        * config/rs6000/rs6000.h (machine_function): Add insn_chain_scanned_p.
+	* config/rs6000/rs6000.h (machine_function): Add insn_chain_scanned_p.
 
 Tue Mar 11 21:19:03 2003  Alexandre Oliva  <aoliva@redhat.com>
 
@@ -545,8 +553,8 @@ Tue Mar 11 22:48:03 CET 2003  Jan Hubicka  <jh@suse.cz>
 
 2003-03-11  Aldy Hernandez  <aldyh@redhat.com>
 
-        * config/rs6000/rs6000.c (rs6000_override_options): Disable string
-        instructions for e500.
+	* config/rs6000/rs6000.c (rs6000_override_options): Disable string
+	instructions for e500.
 
 2003-03-11  Neil Booth  <neil@daikokuya.co.uk>
 
@@ -555,23 +563,23 @@ Tue Mar 11 22:48:03 CET 2003  Jan Hubicka  <jh@suse.cz>
 
 2003-03-11  Aldy Hernandez  <aldyh@redhat.com>
 
-        * doc/tm.texi (Frame Registers): Document DWARF_REG_TO_UNWIND_COLUMN.
+	* doc/tm.texi (Frame Registers): Document DWARF_REG_TO_UNWIND_COLUMN.
 
-        * unwind-dw2.c (DWARF_REG_TO_UNWIND_COLUMN): Define.
-        (_Unwind_GetGR): Use DWARF_REG_TO_UNWIND_COLUMN.
-        (_Unwind_SetGR): Same.
-        (_Unwind_GetGRPtr): New.
-        (_Unwind_SetGRPtr): New.
-        (uw_update_context_1): Use accesor functions instead of accessing
-        context->reg[] directly.
-        (uw_install_context_1): Same.
-        (execute_cfa_program): Same.
-        (__frame_state_for): Same.
+	* unwind-dw2.c (DWARF_REG_TO_UNWIND_COLUMN): Define.
+	(_Unwind_GetGR): Use DWARF_REG_TO_UNWIND_COLUMN.
+	(_Unwind_SetGR): Same.
+	(_Unwind_GetGRPtr): New.
+	(_Unwind_SetGRPtr): New.
+	(uw_update_context_1): Use accesor functions instead of accessing
+	context->reg[] directly.
+	(uw_install_context_1): Same.
+	(execute_cfa_program): Same.
+	(__frame_state_for): Same.
 
-        * config/rs6000/rs6000.c (spe_synthesize_frame_save): Use 1200 as
-        the synthetic register offset.
+	* config/rs6000/rs6000.c (spe_synthesize_frame_save): Use 1200 as
+	the synthetic register offset.
 
-        * config/rs6000/rs6000.h (DWARF_REG_TO_UNWIND_COLUMN): New.
+	* config/rs6000/rs6000.h (DWARF_REG_TO_UNWIND_COLUMN): New.
 
 2003-03-11  Hans-Peter Nilsson  <hp@axis.com>
 
@@ -623,7 +631,7 @@ Tue Mar 11 22:48:03 CET 2003  Jan Hubicka  <jh@suse.cz>
 
 2003-03-10  Aldy Hernandez  <aldyh@redhat.com>
 
-        * dwarf2out.c (multiple_reg_loc_descriptor): Fix thinko.
+	* dwarf2out.c (multiple_reg_loc_descriptor): Fix thinko.
 
 2003-03-10  Andrew Pinski  <apinski@apple.com>
 
diff --git a/gcc/doc/gccint.texi b/gcc/doc/gccint.texi
index b6bec095fa0..e69f67fc87d 100644
--- a/gcc/doc/gccint.texi
+++ b/gcc/doc/gccint.texi
@@ -140,6 +140,7 @@ Additional tutorial information is linked to from
 * Contributing::    How to contribute to testing and developing GCC.
 * Portability::     Goals of GCC's portability features.
 * Interface::       Function-call interface of GCC output.
+* Libgcc::          Low-level runtime library used by GCC.
 * Languages::       Languages for which GCC front ends are written.
 * Source Tree::     GCC source tree structure and build system.
 * Passes::          Order of passes, what they do, and what each file is for.
@@ -168,6 +169,7 @@ Additional tutorial information is linked to from
 @include contribute.texi
 @include portability.texi
 @include interface.texi
+@include libgcc.texi
 @include languages.texi
 @include sourcebuild.texi
 @include passes.texi
diff --git a/gcc/doc/interface.texi b/gcc/doc/interface.texi
index c554434c447..d2210e93865 100644
--- a/gcc/doc/interface.texi
+++ b/gcc/doc/interface.texi
@@ -83,20 +83,3 @@ go in a register:
   @dots{}
 @}
 @end example
-
-@cindex arithmetic libraries
-@cindex math libraries
-@opindex msoft-float
-Code compiled with GCC may call certain library routines.  Most of
-them handle arithmetic for which there are no instructions.  This
-includes multiply and divide on some machines, and floating point
-operations on any machine for which floating point support is disabled
-with @option{-msoft-float}.  Some standard parts of the C library, such as
-@code{bcopy} or @code{memcpy}, are also called automatically.  The usual
-function call interface is used for calling the library routines.
-
-Some of these routines can be defined in mostly machine-independent C;
-they appear in @file{libgcc2.c}.  Others must be hand-written in
-assembly language for each processor.  Wherever they are defined, they
-are compiled into the support library, @file{libgcc.a}, which is
-automatically searched when you link programs with GCC@.
diff --git a/gcc/doc/libgcc.texi b/gcc/doc/libgcc.texi
new file mode 100644
index 00000000000..19074ba985a
--- /dev/null
+++ b/gcc/doc/libgcc.texi
@@ -0,0 +1,368 @@
+@c Copyright (C) 2003 Free Software Foundation, Inc.
+@c This is part of the GCC manual.
+@c For copying conditions, see the file gcc.texi.
+@c Contributed by Aldy Hernandez <aldy@quesejoda.com>
+
+@node Libgcc
+@chapter The GCC low-level runtime library
+
+GCC provides a low-level runtime library, @file{libgcc.a} or
+@file{libgcc_s.so.1} on some platforms.  GCC generates calls to
+routines in this library automatically, whenever it needs to perform
+some operation that is too complicated to emit inline code for.
+
+Most of the routines in @code{libgcc} handle arithmetic operations
+that the target processor cannot perform directly.  This includes
+integer multiply and divide on some machines, and all floating-point
+operations on other machines.  @code{libgcc} also includes routines
+for exception handling, and a handful of miscellaneous operations.
+
+Some of these routines can be defined in mostly machine-independent C.
+Others must be hand-written in assembly language for each processor
+that needs them.
+
+GCC will also generate calls to C library routines, such as
+@code{memcpy} and @code{memset}, in some cases.  The set of routines
+that GCC may possibly use is documented in @ref{Other
+Builtins,,,gcc, Using the GNU Compiler Collection (GCC)}.
+
+@menu
+* Integer library routines::
+* Soft float library routines::
+* Exception handling routines::
+* Miscellaneous routines:: 
+@end menu
+
+@node Integer library routines
+@section Routines for integer arithmetic
+
+document me!
+
+@example
+  __absvsi2
+  __addvsi3
+  __ashlsi3
+  __ashrsi3
+  __divsi3
+  __lshrsi3
+  __modsi3
+  __mulsi3
+  __mulvsi3
+  __negvsi2
+  __subvsi3
+  __udivsi3
+  __umodsi3
+
+  __absvdi2
+  __addvdi3
+  __ashldi3
+  __ashrdi3
+  __cmpdi2
+  __divdi3
+  __ffsdi2
+  __fixdfdi
+  __fixsfdi
+  __fixtfdi
+  __fixxfdi
+  __fixunsdfdi
+  __fixunsdfsi
+  __fixunssfsi
+  __fixunssfdi
+  __fixunstfdi
+  __fixunstfsi
+  __fixunsxfdi
+  __fixunsxfsi
+  __floatdidf
+  __floatdisf
+  __floatdixf
+  __floatditf
+  __lshrdi3
+  __moddi3
+  __muldi3
+  __mulvdi3
+  __negdi2
+  __negvdi2
+  __subvdi3
+  __ucmpdi2
+  __udivdi3
+  __udivmoddi4
+  __umoddi3
+
+  __ashlti3
+  __ashrti3
+  __cmpti2
+  __divti3
+  __ffsti2
+  __fixdfti
+  __fixsfti
+  __fixtfti
+  __fixxfti
+  __lshrti3
+  __modti3
+  __multi3
+  __negti2
+  __ucmpti2
+  __udivmodti4
+  __udivti3
+  __umodti3
+  __fixunsdfti
+  __fixunssfti
+  __fixunstfti
+  __fixunsxfti
+  __floattidf
+  __floattisf
+  __floattixf
+  __floattitf
+
+  __clzsi2
+  __clzdi2
+  __clzti2
+  __ctzsi2
+  __ctzdi2
+  __ctzti2
+  __popcountsi2
+  __popcountdi2
+  __popcountti2
+  __paritysi2
+  __paritydi2
+  __parityti2
+@end example
+
+
+@node Soft float library routines
+@section Routines for floating point emulation
+@cindex soft float library
+@cindex arithmetic library
+@cindex math library
+@opindex msoft-float
+
+The software floating point library is used on machines which do not
+have hardware support for floating point.  It is also used whenever
+@option{-msoft-float} is used to disable generation of floating point
+instructions.  (Not all targets support this switch.)
+
+For compatibility with other compilers, the floating point emulation
+routines can be renamed with the @code{DECLARE_LIBRARY_RENAMES} macro
+(@pxref{Library Calls}).  In this section, the default names are used.
+
+These routines take arguments and return values of a specific machine
+mode, not a specific C type.  @xref{Machine Modes}, for an explanation
+of this concept.  For illustrative purposes, in this section
+@code{float} is assumed to correspond to @code{SFmode}; @code{double}
+to @code{DFmode}; @code{@w{long double}} to @code{TFmode}; and
+@code{int} to @code{SImode}.  This is a common mapping, but not the
+only possibility.
+
+Presently the library does not support @code{XFmode}, which is used
+for @code{long double} on some architectures.
+
+@subsection Arithmetic functions
+
+@deftypefn {Runtime Function} float __addsf3 (float @var{a}, float @var{b})
+@deftypefnx {Runtime Function} double __adddf3 (double @var{a}, double @var{b})
+@deftypefnx {Runtime Function} long double __addtf3 (long double @var{a}, long double @var{b})
+These functions return the sum of @var{a} and @var{b}.
+@end deftypefn
+
+@deftypefn {Runtime Function} float __subsf3 (float @var{a}, float @var{b})
+@deftypefnx {Runtime Function} double __subdf3 (double @var{a}, double @var{b})
+@deftypefnx {Runtime Function} long double __subtf3 (long double @var{a}, long double @var{b})
+These functions return the difference between @var{b} and @var{a};
+that is, @w{@math{@var{a} - @var{b}}}.
+@end deftypefn
+
+@deftypefn {Runtime Function} float __mulsf3 (float @var{a}, float @var{b})
+@deftypefnx {Runtime Function} double __muldf3 (double @var{a}, double @var{b})
+@deftypefnx {Runtime Function} long double __multf3 (long double @var{a}, long double @var{b})
+These functions return the product of @var{a} and @var{b}.
+@end deftypefn
+
+@deftypefn {Runtime Function} float __divsf3 (float @var{a}, float @var{b})
+@deftypefnx {Runtime Function} double __divdf3 (double @var{a}, double @var{b})
+@deftypefnx {Runtime Function} long double __divtf3 (long double @var{a}, long double @var{b})
+These functions return the quotient of @var{a} and @var{b}; that is,
+@w{@math{@var{a} / @var{b}}}.
+@end deftypefn
+
+@deftypefn {Runtime Function} double __negdf2 (double @var{a})
+@deftypefnx {Runtime Function} long double __negtf2 (long double @var{a})
+@deftypefnx {Runtime Function} float __negsf2 (float @var{a})
+These functions return the negation of @var{a}.  They simply flip the
+sign bit, so they can produce negative zero and negative NaN.
+@end deftypefn
+
+@subsection Conversion functions
+
+@deftypefn {Runtime Function} double __extendsfdf2 (float @var{a})
+@deftypefnx {Runtime Function} long double __extendsftf2 (float @var{a})
+@deftypefnx {Runtime Function} long double __extenddftf2 (double @var{a})
+These functions extend @var{a} to the wider mode of their return
+type.
+@end deftypefn
+
+@deftypefn {Runtime Function} double __trunctfdf2 (long double @var{a})
+@deftypefnx {Runtime Function} float __trunctfsf2 (long double @var{a})
+@deftypefnx {Runtime Function} float __truncdfsf2 (double @var{a})
+These functions truncate @var{a} to the narrower mode of their return
+type, rounding toward zero.
+@end deftypefn
+
+@deftypefn {Runtime Function} int __fixsfsi (float @var{a})
+@deftypefnx {Runtime Function} int __fixdfsi (double @var{a})
+@deftypefnx {Runtime Function} int __fixtfsi (long double @var{a})
+These functions convert @var{a} to a signed integer, rounding toward zero.
+@end deftypefn
+
+@deftypefn {Runtime Function} unsigned int __fixunssfsi (float @var{a})
+@deftypefnx {Runtime Function} unsigned int __fixunsdfsi (double @var{a})
+@deftypefnx {Runtime Function} unsigned int __fixunstfsi (long double @var{a})
+These functions convert @var{a} to an unsigned integer, rounding
+toward zero.  Negative values all become zero.
+@end deftypefn
+
+@deftypefn {Runtime Function} float __floatsisf (int @var{i})
+@deftypefnx {Runtime Function} double __floatsidf (int @var{i})
+@deftypefnx {Runtime Function} long double __floatsitf (int @var{i})
+These functions convert @var{i}, a signed integer, to floating point.
+@end deftypefn
+
+@deftypefn {Runtime Function} float __floatunsisf (unsigned int @var{n})
+@deftypefnx {Runtime Function} double __floatunsidf (unsigned int @var{n})
+@deftypefnx {Runtime Function} long double __floatunsitf (unsigned int @var{n})
+These functions convert @var{n}, an unsigned integer, to floating point.
+@end deftypefn
+
+There are no functions to convert @code{DImode} integers to or from
+floating point; this reflects the fact that such conversions are rare,
+and processors with native 64-bit arithmetic tend to have hardware
+floating point support.  If such routines ever get added, they will be
+named @code{__fixsfdi}, @code{__floatdisf}, and so on.
+
+@subsection Comparison functions
+
+There are two sets of basic comparison functions.
+
+@deftypefn {Runtime Function} int __cmpsf2 (float @var{a}, float @var{b})
+@deftypefnx {Runtime Function} int __cmpdf2 (double @var{a}, double @var{b})
+@deftypefnx {Runtime Function} int __cmptf2 (long double @var{a}, long double @var{b})
+These functions calculate @math{a <=> b}.  That is, if @var{a} is less
+than @var{b}, they return -1; if @var{a} is greater than @var{b}, they
+return 1; and if @var{a} and @var{b} are equal they return 0.  If
+either argument is NaN they return 1, but you should not rely on this;
+if NaN is a possibility, use one of the higher-level comparison
+functions.
+@end deftypefn
+
+@deftypefn {Runtime Function} int __unordsf2 (float @var{a}, float @var{b})
+@deftypefnx {Runtime Function} int __unorddf2 (double @var{a}, double @var{b})
+@deftypefnx {Runtime Function} int __unordtf2 (long double @var{a}, long double @var{b})
+These functions return 1 if either argument is NaN, otherwise 0.
+@end deftypefn
+
+There is also a complete group of higher level functions which
+correspond directly to comparison operators.  They implement the ISO@tie{}C
+semantics for floating-point comparisons, taking NaN into account.
+Pay careful attention to the return values defined for each set.
+Under the hood, all of these routines are implemented as
+
+@smallexample
+  if (__unord@var{X}f2 (a, b))
+    return @var{E};
+  return __cmp@var{X}f2 (a, b);
+@end smallexample
+
+@noindent
+where @var{E} is a constant chosen to give the proper behavior for
+NaN.  Thus, the meaning of the return value is different for each set.
+Do not rely on this implementation; only the semantics documented
+below are guaranteed.
+
+@deftypefn {Runtime Function} int __eqsf2 (float @var{a}, float @var{b})
+@deftypefnx {Runtime Function} int __eqdf2 (double @var{a}, double @var{b})
+@deftypefnx {Runtime Function} int __eqtf2 (long double @var{a}, long double @var{b})
+These functions return zero if neither argument is NaN, and @var{a} and
+@var{b} are equal.
+@end deftypefn
+
+@deftypefn {Runtime Function} int __nesf2 (float @var{a}, float @var{b})
+@deftypefnx {Runtime Function} int __nedf2 (double @var{a}, double @var{b})
+@deftypefnx {Runtime Function} int __netf2 (long double @var{a}, long double @var{b})
+These functions return a nonzero value if either argument is NaN, or
+if @var{a} and @var{b} are unequal.
+@end deftypefn
+
+@deftypefn {Runtime Function} int __gesf2 (float @var{a}, float @var{b})
+@deftypefnx {Runtime Function} int __gedf2 (double @var{a}, double @var{b})
+@deftypefnx {Runtime Function} int __getf2 (long double @var{a}, long double @var{b})
+These functions return a value greater than or equal to zero if
+neither argument is NaN, and @var{a} is greater than or equal to
+@var{b}.
+@end deftypefn
+
+@deftypefn {Runtime Function} int __ltsf2 (float @var{a}, float @var{b})
+@deftypefnx {Runtime Function} int __ltdf2 (double @var{a}, double @var{b})
+@deftypefnx {Runtime Function} int __lttf2 (long double @var{a}, long double @var{b})
+These functions return a value less than zero if neither argument is
+NaN, and @var{a} is strictly less than @var{b}.
+@end deftypefn
+
+@deftypefn {Runtime Function} int __lesf2 (float @var{a}, float @var{b})
+@deftypefnx {Runtime Function} int __ledf2 (double @var{a}, double @var{b})
+@deftypefnx {Runtime Function} int __letf2 (long double @var{a}, long double @var{b})
+These functions return a value less than or equal to zero if neither
+argument is NaN, and @var{a} is less than or equal to @var{b}.
+@end deftypefn
+
+@deftypefn {Runtime Function} int __gtsf2 (float @var{a}, float @var{b})
+@deftypefnx {Runtime Function} int __gtdf2 (double @var{a}, double @var{b})
+@deftypefnx {Runtime Function} int __gttf2 (long double @var{a}, long double @var{b})
+These functions return a value greater than zero if neither argument
+is NaN, and @var{a} is strictly greater than @var{b}.
+@end deftypefn
+
+@node Exception handling routines
+@section Language-independent routines for exception handling
+
+document me!
+
+@example
+  _Unwind_DeleteException
+  _Unwind_Find_FDE
+  _Unwind_ForcedUnwind
+  _Unwind_GetGR
+  _Unwind_GetIP
+  _Unwind_GetLanguageSpecificData
+  _Unwind_GetRegionStart
+  _Unwind_GetTextRelBase
+  _Unwind_GetDataRelBase
+  _Unwind_RaiseException
+  _Unwind_Resume
+  _Unwind_SetGR
+  _Unwind_SetIP
+  _Unwind_FindEnclosingFunction
+  _Unwind_SjLj_Register
+  _Unwind_SjLj_Unregister
+  _Unwind_SjLj_RaiseException
+  _Unwind_SjLj_ForcedUnwind
+  _Unwind_SjLj_Resume
+  __deregister_frame
+  __deregister_frame_info
+  __deregister_frame_info_bases
+  __register_frame
+  __register_frame_info
+  __register_frame_info_bases
+  __register_frame_info_table
+  __register_frame_info_table_bases
+  __register_frame_table
+@end example
+
+@node Miscellaneous routines
+@section Miscellaneous runtime library routines
+
+document me!
+
+@example
+  __clear_cache
+@end example
+
+any others?