From patchwork Sat Mar 10 02:04:31 2012 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Sandra Loosemore X-Patchwork-Id: 145790 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 6D24DB6F9D for ; Sat, 10 Mar 2012 13:05:01 +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=1331949902; h=Comment: DomainKey-Signature:Received:Received:Received:Received:Received: Received:Message-ID:Date:From:User-Agent:MIME-Version:To:Subject: Content-Type:Mailing-List:Precedence:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:Sender:Delivered-To; bh=93ulEsH yuf6inx45Q0kDzqiK84k=; b=xno+/rjKQjx9UjkRjkqSIOpycbYkWlnsYHcCduV LKYE/vVe3O9IpS681pWjGk6C8lXc8cshWutQGIpdUBsHpsaDqexuEULBFS1PvVuL X2aQfXFb4SXUjl/rLYTryNFT9hFlCrS7nJUqbgChASIc9g+WSPndAyVivQYYX6Sc 7j30= 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:Received:Received:Message-ID:Date:From:User-Agent:MIME-Version:To:Subject:Content-Type:Mailing-List:Precedence:List-Id:List-Unsubscribe:List-Archive:List-Post:List-Help:Sender:Delivered-To; b=aQRM87WZf4ZRSfYmAtIcqzBe3qLNKJfweUesbyAotaaQNpePR3wYeqcHK0nC6C 0tGZ4isP07OsIk7XRi8XAW8QjdTtimfUXYpspqhJ7stKBS3SOoGXrpz5sITpqiRa PDgtJChmULehcegGoAFVeq6/WOVxoTKY+84ZsSyu+7pcE=; Received: (qmail 23033 invoked by alias); 10 Mar 2012 02:04:57 -0000 Received: (qmail 23024 invoked by uid 22791); 10 Mar 2012 02:04:56 -0000 X-SWARE-Spam-Status: No, hits=-1.0 required=5.0 tests=AWL, BAYES_00, FROM_12LTRDOM, TW_GD X-Spam-Check-By: sourceware.org Received: from relay1.mentorg.com (HELO relay1.mentorg.com) (192.94.38.131) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Sat, 10 Mar 2012 02:04:41 +0000 Received: from svr-orw-fem-01.mgc.mentorg.com ([147.34.98.93]) by relay1.mentorg.com with esmtp id 1S6Bfk-0000GB-F5 from Sandra_Loosemore@mentor.com for gcc-patches@gcc.gnu.org; Fri, 09 Mar 2012 18:04:40 -0800 Received: from SVR-ORW-FEM-03.mgc.mentorg.com ([147.34.97.39]) by svr-orw-fem-01.mgc.mentorg.com over TLS secured channel with Microsoft SMTPSVC(6.0.3790.4675); Fri, 9 Mar 2012 18:04:39 -0800 Received: from [IPv6:::1] (147.34.91.1) by svr-orw-fem-03.mgc.mentorg.com (147.34.97.39) with Microsoft SMTP Server id 14.1.289.1; Fri, 9 Mar 2012 18:04:39 -0800 Message-ID: <4F5AB6AF.1070100@codesourcery.com> Date: Fri, 9 Mar 2012 19:04:31 -0700 From: Sandra Loosemore User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.9.2.13) Gecko/20101208 Lightning/1.0b2 Thunderbird/3.1.7 MIME-Version: 1.0 To: Subject: [patch, committed] invoke.texi: DWARF, stabs, and ELF 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 Per the DWARF web site http://dwarfstd.org/Download.php the correct names of the various versions of the DWARF standard appear to be either "DWARF Version N" or "DWARF N", rather than e.g. "DWARF2", "DWARF-2", "dwarf2", or whatever. This patch to invoke.texi makes usages reflect the official names. Similarly, I've fixed up a couple instances of incorrect usage of "stabs" (official name seems to be all lowercase, like that) and "ELF". Checked in to trunk as obvious. -Sandra 2012-03-09 Sandra Loosemore gcc/ * doc/invoke.texi: Use correct names for "DWARF", "stabs", and "ELF". Index: gcc/doc/invoke.texi =================================================================== --- gcc/doc/invoke.texi (revision 185148) +++ gcc/doc/invoke.texi (working copy) @@ -4756,7 +4756,7 @@ factor of two. @item -fno-debug-types-section @opindex fno-debug-types-section @opindex fdebug-types-section -By default when using DWARF v4 or higher type DIEs will be put into +By default when using DWARF Version 4 or higher type DIEs will be put into their own .debug_types section instead of making them part of the .debug_info section. It is more efficient to put them in a separate comdat sections since the linker will then be able to remove duplicates. @@ -4794,7 +4794,7 @@ Produce debugging information in DWARF f supported). This is the format used by DBX on IRIX 6. The value of @var{version} may be either 2, 3 or 4; the default version is 2. -Note that with DWARF version 2 some ports require, and will always +Note that with DWARF Version 2 some ports require, and will always use, some non-conflicting DWARF 3 extensions in the unwind tables. Version 4 may require GDB 7.0 and @option{-fvar-tracking-assignments} @@ -4919,9 +4919,9 @@ other than debugging the compiler proper @item -feliminate-dwarf2-dups @opindex feliminate-dwarf2-dups -Compress DWARF2 debugging information by eliminating duplicated +Compress DWARF 2 debugging information by eliminating duplicated information about each symbol. This option only makes sense when -generating DWARF2 debugging information with @option{-gdwarf-2}. +generating DWARF 2 debugging information with @option{-gdwarf-2}. @item -femit-struct-debug-baseonly Emit debug information for struct-like types @@ -6096,7 +6096,7 @@ is used when GCC itself is being built.) @item -feliminate-unused-debug-types @opindex feliminate-unused-debug-types -Normally, when producing DWARF2 output, GCC will emit debugging +Normally, when producing DWARF 2 output, GCC will emit debugging information for all types declared in a compilation unit, regardless of whether or not they are actually used in that compilation unit. Sometimes this is useful, such as @@ -11764,7 +11764,7 @@ is default. @item -msim @opindex msim Links the library libsim.a which is in compatible with simulator. Applicable -to elf compiler only. +to ELF compiler only. @item -mint32 @opindex mint32 @@ -11851,7 +11851,7 @@ warn about constructs contained within h @item -gused @opindex gused -Emit debugging information for symbols that are used. For STABS +Emit debugging information for symbols that are used. For stabs debugging format, this enables @option{-feliminate-unused-debug-symbols}. This is by default ON@. @@ -17651,7 +17651,7 @@ type. This is the default. Store (do not store) the address of the caller's frame as backchain pointer into the callee's stack frame. A backchain may be needed to allow debugging using tools that do not understand -DWARF-2 call frame information. +DWARF 2 call frame information. When @option{-mno-packed-stack} is in effect, the backchain pointer is stored at the bottom of the stack frame; when @option{-mpacked-stack} is in effect, the backchain is placed into the topmost word of the 96/160 byte register @@ -19156,7 +19156,7 @@ that needs this handling would enable it @item -fasynchronous-unwind-tables @opindex fasynchronous-unwind-tables -Generate unwind table in dwarf2 format, if supported by target machine. The +Generate unwind table in DWARF 2 format, if supported by target machine. The table is exact at each instruction boundary, so it can be used for stack unwinding from asynchronous events (such as debugger or garbage collector).