Patchwork [committed] invoke.texi: DWARF, stabs, and ELF

login
register
mail settings
Submitter Sandra Loosemore
Date March 10, 2012, 2:04 a.m.
Message ID <4F5AB6AF.1070100@codesourcery.com>
Download mbox | patch
Permalink /patch/145790/
State New
Headers show

Comments

Sandra Loosemore - March 10, 2012, 2:04 a.m.
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  <sandra@codesourcery.com>

	gcc/
	* doc/invoke.texi: Use correct names for "DWARF", "stabs", and "ELF".
Gerald Pfeifer - March 18, 2012, 9 p.m.
On Fri, 9 Mar 2012, Sandra Loosemore wrote:
> 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".

I like the other changes, but find "DWARF Version N" with an uppercase
V in "Version" a bit unnatural and would prefer to just use the lowercase 
"version" here.

Gerald
Sandra Loosemore - March 18, 2012, 9:27 p.m.
On 03/18/2012 03:00 PM, Gerald Pfeifer wrote:
> On Fri, 9 Mar 2012, Sandra Loosemore wrote:
>> 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".
>
> I like the other changes, but find "DWARF Version N" with an uppercase
> V in "Version" a bit unnatural and would prefer to just use the lowercase
> "version" here.

Personally, I agree, but I think the principle that we must prefer to 
call things by their proper/official names takes precedence.  The DWARF 
documentation seems to consistently use uppercase-V "Version" in running 
text as well as the document titles.

-Sandra

Patch

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).