There is a function defined in builtins.def as __builtin_extract_return_addr. The function is used by that name in libgcc/unwind-dw2.c. For some reason the documentation for this function uses the name __builtin_extract_return_address. This patch corrects the documentation to match the definition and usage. Bootstrapped on x86_64-unknown-linux-gnu. Committed as obvious.
Ian 2012-10-16 Ian Lance Taylor <i...@google.com> * doc/extend.texi (Return Address): Change __builtin_extract_return_address to __builtin_extract_return_addr.
Index: extend.texi =================================================================== --- extend.texi (revision 192524) +++ extend.texi (working copy) @@ -6769,13 +6769,13 @@ random value. In addition, @code{__buil to determine if the top of the stack has been reached. Additional post-processing of the returned value may be needed, see -@code{__builtin_extract_return_address}. +@code{__builtin_extract_return_addr}. This function should only be used with a nonzero argument for debugging purposes. @end deftypefn -@deftypefn {Built-in Function} {void *} __builtin_extract_return_address (void *@var{addr}) +@deftypefn {Built-in Function} {void *} __builtin_extract_return_addr (void *@var{addr}) The address as returned by @code{__builtin_return_address} may have to be fed through this function to get the actual encoded address. For example, on the 31-bit S/390 platform the highest bit has to be masked out, or on SPARC @@ -6786,7 +6786,7 @@ If no fixup is needed, this function sim @end deftypefn @deftypefn {Built-in Function} {void *} __builtin_frob_return_address (void *@var{addr}) -This function does the reverse of @code{__builtin_extract_return_address}. +This function does the reverse of @code{__builtin_extract_return_addr}. @end deftypefn @deftypefn {Built-in Function} {void *} __builtin_frame_address (unsigned int @var{level})