From patchwork Wed Oct 17 05:18:04 2012 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ian Lance Taylor X-Patchwork-Id: 191968 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from sourceware.org (server1.sourceware.org [209.132.180.131]) by ozlabs.org (Postfix) with SMTP id 25D502C00A7 for ; Wed, 17 Oct 2012 16:18:23 +1100 (EST) Comment: DKIM? See http://www.dkim.org DKIM-Signature: v=1; a=rsa-sha1; c=relaxed/relaxed; d=gcc.gnu.org; s=default; x=1351055905; h=Comment: DomainKey-Signature:Received:Received:Received:Received:Received: Received:From:To:Subject:Date:Message-ID:User-Agent:MIME-Version: Content-Type:Mailing-List:Precedence:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:Sender:Delivered-To; bh=t0Xpl5e 8NM8QKTgcc+TXjf3qJy0=; b=DFDOv+MP+gTSP1vsPu67I4QjnRxJbr7AzHlh2P0 wg1KoZoIiZAUTPHX6H2hUrq/N5NfqHhw0tFor4DZWaUrj276cbSRtW54SApqT6a/ iTFfvwyVx1GiRjYGC57rtA+binBU30nKEUa6VwPZfDLRbiID/sh3o+XV8VbvzX3f AsKM= Comment: DomainKeys? See http://antispam.yahoo.com/domainkeys DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws; s=default; d=gcc.gnu.org; h=Received:Received:X-SWARE-Spam-Status:X-Spam-Check-By:Received:Received:X-Google-DKIM-Signature:Received:Received:From:To:Subject:Date:Message-ID:User-Agent:MIME-Version:Content-Type:X-Gm-Message-State:X-IsSubscribed:Mailing-List:Precedence:List-Id:List-Unsubscribe:List-Archive:List-Post:List-Help:Sender:Delivered-To; b=leS9Mi7MfX/tSDFfHjVKNqO857MILDqy2ALOGvcl7FYSOnnvW0S2dsdrlJpg2e HX8rZiUTUOyPTwwFy+vRc02JxFIXXilKGyNc2oS642VXkKmyv+N8sMuN6WQUgnd/ PH8F4DkiMj4CbCBQO1VUrc4ObH4tK7N2TV4Da92A2Zqfg=; Received: (qmail 5031 invoked by alias); 17 Oct 2012 05:18:18 -0000 Received: (qmail 5023 invoked by uid 22791); 17 Oct 2012 05:18:17 -0000 X-SWARE-Spam-Status: No, hits=-4.5 required=5.0 tests=AWL, BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, KHOP_RCVD_TRUST, RCVD_IN_DNSWL_LOW, RCVD_IN_HOSTKARMA_YE, RP_MATCHES_RCVD, T_TVD_MIME_NO_HEADERS X-Spam-Check-By: sourceware.org Received: from mail-pa0-f47.google.com (HELO mail-pa0-f47.google.com) (209.85.220.47) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Wed, 17 Oct 2012 05:18:07 +0000 Received: by mail-pa0-f47.google.com with SMTP id fa11so6748039pad.20 for ; Tue, 16 Oct 2012 22:18:06 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20120113; h=from:to:subject:date:message-id:user-agent:mime-version :content-type:x-gm-message-state; bh=Ok3Sbq5tgcZHHe0mIBZiWVU6XSGfnXpuX1wsLHzCJGY=; b=oBQ1b+GC90UhQQdYkDMwG/8bAh7UrGedfxGqy/BDHYhQgXrx2ZoZj7mUEMB452uT3t aUcP04JBZPyZiRDxfVK1B+/enL0cN0QeklCRQtj/UBCQjv+p7HKrsELa233nmGgDSk/u +n4imzQKc9qtat+NClkxt1Nx1BHwFxNnW4QMbO4eU6Ic7TKB9hC0FxxQXmo6ZVlTwdUZ bgrZpHA/aORqwdy1EdoxVrzuSRWcOIJLP3pOrslYSdSA94EaaYj/lTcXeHbXQH8fd7Jh u10RUqIulWCBOXH7XaOkReagSXNU0Pr4dlr4vCP3yAhfOV0JkJAugV6SD9U4iglrk7Le 45OA== Received: by 10.66.90.36 with SMTP id bt4mr47669012pab.54.1350451086620; Tue, 16 Oct 2012 22:18:06 -0700 (PDT) Received: from coign.google.com (adsl-71-133-8-30.dsl.pltn13.pacbell.net. [71.133.8.30]) by mx.google.com with ESMTPS id ms11sm1696423pbc.74.2012.10.16.22.18.05 (version=TLSv1/SSLv3 cipher=OTHER); Tue, 16 Oct 2012 22:18:05 -0700 (PDT) From: Ian Lance Taylor To: gcc-patches@gcc.gnu.org Subject: Doc patch committed: Fix name of __builtin_extract_return_addr Date: Tue, 16 Oct 2012 22:18:04 -0700 Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.1 (gnu/linux) MIME-Version: 1.0 X-Gm-Message-State: ALoCoQk6FT7xrcv4tWhGJOuprgn85BHf3ovtieWCezx7DLoquSlyqXNEYJs/TPNu0s9qmB/TvPY8pO4GcReuHANiwrLV2jhu877v9BPIGg56sHw4C9yVTlpuEk/7PBB16JHiUSP3HTGR1F6iRptlgqubOlSQ8yILuIslVRGlBXAHe5w/rhs2+M9yKqbwAkSEYrmNziYeRGawIH6JVmwcXg6NUrwnSBjEcw== X-IsSubscribed: yes Mailing-List: contact gcc-patches-help@gcc.gnu.org; run by ezmlm Precedence: bulk List-Id: List-Unsubscribe: List-Archive: List-Post: List-Help: Sender: gcc-patches-owner@gcc.gnu.org Delivered-To: mailing list gcc-patches@gcc.gnu.org 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 * 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})