gdb/doc/stabs.info - Issue 124383005: GDB 7.6.50

Unified Diff: gdb/doc/stabs.info

Issue 124383005: GDB 7.6.50 (Closed) Base URL: http://git.chromium.org/native_client/nacl-gdb.git@upstream

Patch Set: Created 6 years, 11 months ago

Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.

Jump to:

View side-by-side diff with in-line comments

Index: gdb/doc/stabs.info

diff --git a/gdb/doc/stabs.info b/gdb/doc/stabs.info

index d5f2bd12e4d703f7a90815c5df1aa6638cdc1362..46306815e20a5edcab2bfb8e78d9b85f410c9411 100644

--- a/gdb/doc/stabs.info

+++ b/gdb/doc/stabs.info

@@ -1,4 +1,4 @@

-This is stabs.info, produced by makeinfo version 4.8 from

+This is stabs.info, produced by makeinfo version 4.13 from

./stabs.texinfo.

INFO-DIR-SECTION Software development

@@ -6,9 +6,9 @@ START-INFO-DIR-ENTRY

* Stabs: (stabs). The "stabs" debugging information format.

END-INFO-DIR-ENTRY

-Software Foundation, Inc. Contributed by Cygnus Support. Written by

-Julia Menapace, Jim Kingdon, and David MacKenzie.

+by Cygnus Support. Written by Julia Menapace, Jim Kingdon, and David

+MacKenzie.

Permission is granted to copy, distribute and/or modify this document

under the terms of the GNU Free Documentation License, Version 1.3 or

@@ -19,9 +19,9 @@ Free Documentation License".

This document describes the stabs debugging symbol tables.

-Software Foundation, Inc. Contributed by Cygnus Support. Written by

-Julia Menapace, Jim Kingdon, and David MacKenzie.

+by Cygnus Support. Written by Julia Menapace, Jim Kingdon, and David

+MacKenzie.

Permission is granted to copy, distribute and/or modify this document

under the terms of the GNU Free Documentation License, Version 1.3 or

@@ -144,7 +144,7 @@ XCOFF assembler uses `.stabx' (and some other directives such as

.stabx "STRING",VALUE,TYPE,SDB-TYPE

For `.stabn' and `.stabd', there is no STRING (the `n_strx' field is

-zero; see *Note Symbol Tables::). For `.stabd', the VALUE field is

+zero; see *note Symbol Tables::). For `.stabd', the VALUE field is

implicit and has the value of the current file location. For `.stabx',

the SDB-TYPE field is unused for stabs and can always be set to zero.

The OTHER field is almost always unused and can be set to zero.

@@ -185,7 +185,7 @@ altogether; apparently that is supported by most debuggers.

that tells more specifically what kind of symbol the stab represents.

If the SYMBOL-DESCRIPTOR is omitted, but type information follows, then

the stab represents a local variable. For a list of symbol

-descriptors, see *Note Symbol Descriptors::. The `c' symbol descriptor

+descriptors, see *note Symbol Descriptors::. The `c' symbol descriptor

is an exception in that it is not followed by type information. *Note

Constants::.

@@ -206,7 +206,7 @@ type is about to be defined. Any other values following the

TYPE-DESCRIPTOR vary, depending on the TYPE-DESCRIPTOR. *Note Type

Descriptors::, for a list of TYPE-DESCRIPTOR values. If a number

follows the `=' then the number is a TYPE-REFERENCE. For a full

-description of types, *Note Types::.

+description of types, *note Types::.

A TYPE-NUMBER is often a single number. The GNU and Sun tools

additionally permit a TYPE-NUMBER to be a pair

@@ -216,7 +216,7 @@ base source file, 1 for the first included file, 2 for the next, and so

on. The FILETYPE-NUMBER is a number starting with 1 which is

incremented for each new type defined in the file. (Separating the

file number and the type number permits the `N_BINCL' optimization to

-succeed more often; see *Note Include Files::).

+succeed more often; see *note Include Files::).

There is an AIX extension for type attributes. Following the `='

are any number of type attributes. Each one starts with `@' and ends

@@ -573,7 +573,7 @@ looking things up in the ELF symbols would probably be slow, I'm not

sure how to find which symbol of that name is the right one, and this

doesn't provide any way to deal with nested functions, it would

probably be better to make the value of the stab an address relative to

-the start of the file, or just absolute. See *Note ELF Linker

+the start of the file, or just absolute. See *note ELF Linker

Relocation:: for more information on linker relocation of stabs in ELF

files. For XCOFF, the stab uses the `C_FUN' storage class and the

value of the stab is meaningless; the address of the function can be

@@ -846,7 +846,7 @@ variables use the `N_LSYM' stab type, or `C_LSYM' for XCOFF.

The value of the stab is the offset of the variable within the local

variables. On most machines this is an offset from the frame pointer

and is negative. The location of the stab specifies which block it is

-defined in; see *Note Block Structure::.

+defined in; see *note Block Structure::.

For example, the following C code:

@@ -863,8 +863,8 @@ defined in; see *Note Block Structure::.

.stabn 192,0,0,LBB2 # 192 is N_LBRAC

.stabn 224,0,0,LBE2 # 224 is N_RBRAC

- See *Note Procedures:: for more information on the `N_FUN' stab, and

-*Note Block Structure:: for more information on the `N_LBRAC' and

+ See *note Procedures:: for more information on the `N_FUN' stab, and

+*note Block Structure:: for more information on the `N_LBRAC' and

`N_RBRAC' stabs.

@@ -1678,7 +1678,7 @@ File: stabs.info, Node: Miscellaneous Types, Next: Cross-References, Prev: Bu

represented by `M-2;3', where `-2' is a reference to a character

type (*note Negative Type Numbers::). I'm not sure how this

differs from an array. This appears to be a Fortran feature.

- LENGTH is a bound, like those in range types; see *Note

+ LENGTH is a bound, like those in range types; see *note

Subranges::.

`S TYPE-INFORMATION'

@@ -1706,7 +1706,7 @@ yet been defined.

`s' for a structure tag, `u' for a union tag, or `e' for a enumerator

tag, followed by the name of the tag, followed by `:'. If the name

contains `::' between a `<' and `>' pair (for C++ templates), such a

-`::' does not end the name--only a single `:' ends the name; see *Note

+`::' does not end the name--only a single `:' ends the name; see *note

Nested Symbols::.

For example, the following C declarations:

@@ -1768,7 +1768,7 @@ included a trailing semicolon (*note Arrays::).

`J'

There is no bound.

- Subranges are also used for builtin types; see *Note Traditional

+ Subranges are also used for builtin types; see *note Traditional

Builtin Types::.

@@ -1914,7 +1914,7 @@ dbx.

There is no standard way to specify the size of an enumeration type;

it is determined by the architecture (normally all enumerations types

are 32 bits). Type attributes can be used to specify an enumeration

-type of another size for debuggers which support them; see *Note String

+type of another size for debuggers which support them; see *note String

Field::.

Enumeration types are unusual in that they define symbols for the

@@ -1988,7 +1988,7 @@ is a colon followed by the name of the variable which each such field

refers to.

If the structure has methods (a C++ feature), they follow the

-non-method fields; see *Note Cplusplus::.

+non-method fields; see *note Cplusplus::.

File: stabs.info, Node: Typedefs, Next: Unions, Prev: Structures, Up: Types

@@ -2499,8 +2499,8 @@ and the type number of the first base class defining the method.

rather than one. This is followed by a new type definition for the

method. This is a number followed by an equal sign and the type of the

method. Normally this will be a type declared using the `#' type

-descriptor; see *Note Method Type Descriptor::; static member functions

-are declared using the `f' type descriptor instead; see *Note Function

+descriptor; see *note Method Type Descriptor::; static member functions

+are declared using the `f' type descriptor instead; see *note Function

Types::.

The format of an overloaded operator method name differs from that of

@@ -3116,149 +3116,149 @@ full list of stab numbers, including stab types that are used in

languages other than C.

`0x20 N_GSYM'

- Global symbol; see *Note Global Variables::.

+ Global symbol; see *note Global Variables::.

`0x22 N_FNAME'

- Function name (for BSD Fortran); see *Note Procedures::.

+ Function name (for BSD Fortran); see *note Procedures::.

`0x24 N_FUN'

Function name (*note Procedures::) or text segment variable (*note

Statics::).

`0x26 N_STSYM'

- Data segment file-scope variable; see *Note Statics::.

+ Data segment file-scope variable; see *note Statics::.

`0x28 N_LCSYM'

- BSS segment file-scope variable; see *Note Statics::.

+ BSS segment file-scope variable; see *note Statics::.

`0x2a N_MAIN'

- Name of main routine; see *Note Main Program::.

+ Name of main routine; see *note Main Program::.

`0x2c N_ROSYM'

- Variable in `.rodata' section; see *Note Statics::.

+ Variable in `.rodata' section; see *note Statics::.

`0x30 N_PC'

- Global symbol (for Pascal); see *Note N_PC::.

+ Global symbol (for Pascal); see *note N_PC::.

`0x32 N_NSYMS'

- Number of symbols (according to Ultrix V4.0); see *Note N_NSYMS::.

+ Number of symbols (according to Ultrix V4.0); see *note N_NSYMS::.

`0x34 N_NOMAP'

- No DST map; see *Note N_NOMAP::.

+ No DST map; see *note N_NOMAP::.

`0x36 N_MAC_DEFINE'

- Name and body of a `#define'd macro; see *Note Macro define and

+ Name and body of a `#define'd macro; see *note Macro define and

undefine::.

`0x38 N_OBJ'

Object file (Solaris2).

`0x3a N_MAC_UNDEF'

- Name of an `#undef'ed macro; see *Note Macro define and undefine::.

+ Name of an `#undef'ed macro; see *note Macro define and undefine::.

`0x3c N_OPT'

Debugger options (Solaris2).

`0x40 N_RSYM'

- Register variable; see *Note Register Variables::.

+ Register variable; see *note Register Variables::.

`0x42 N_M2C'

- Modula-2 compilation unit; see *Note N_M2C::.

+ Modula-2 compilation unit; see *note N_M2C::.

`0x44 N_SLINE'

- Line number in text segment; see *Note Line Numbers::.

+ Line number in text segment; see *note Line Numbers::.

`0x46 N_DSLINE'

- Line number in data segment; see *Note Line Numbers::.

+ Line number in data segment; see *note Line Numbers::.

`0x48 N_BSLINE'

- Line number in bss segment; see *Note Line Numbers::.

+ Line number in bss segment; see *note Line Numbers::.

`0x48 N_BROWS'

- Sun source code browser, path to `.cb' file; see *Note N_BROWS::.

+ Sun source code browser, path to `.cb' file; see *note N_BROWS::.

`0x4a N_DEFD'

- GNU Modula2 definition module dependency; see *Note N_DEFD::.

+ GNU Modula2 definition module dependency; see *note N_DEFD::.

`0x4c N_FLINE'

Function start/body/end line numbers (Solaris2).

`0x50 N_EHDECL'

- GNU C++ exception variable; see *Note N_EHDECL::.

+ GNU C++ exception variable; see *note N_EHDECL::.

`0x50 N_MOD2'

- Modula2 info "for imc" (according to Ultrix V4.0); see *Note

+ Modula2 info "for imc" (according to Ultrix V4.0); see *note

N_MOD2::.

`0x54 N_CATCH'

- GNU C++ `catch' clause; see *Note N_CATCH::.

+ GNU C++ `catch' clause; see *note N_CATCH::.

`0x60 N_SSYM'

- Structure of union element; see *Note N_SSYM::.

+ Structure of union element; see *note N_SSYM::.

`0x62 N_ENDM'

Last stab for module (Solaris2).

`0x64 N_SO'

- Path and name of source file; see *Note Source Files::.

+ Path and name of source file; see *note Source Files::.

`0x80 N_LSYM'

Stack variable (*note Stack Variables::) or type (*note

Typedefs::).

`0x82 N_BINCL'

- Beginning of an include file (Sun only); see *Note Include Files::.

+ Beginning of an include file (Sun only); see *note Include Files::.

`0x84 N_SOL'

- Name of include file; see *Note Include Files::.

+ Name of include file; see *note Include Files::.

`0xa0 N_PSYM'

- Parameter variable; see *Note Parameters::.

+ Parameter variable; see *note Parameters::.

`0xa2 N_EINCL'

- End of an include file; see *Note Include Files::.

+ End of an include file; see *note Include Files::.

`0xa4 N_ENTRY'

- Alternate entry point; see *Note Alternate Entry Points::.

+ Alternate entry point; see *note Alternate Entry Points::.

`0xc0 N_LBRAC'

- Beginning of a lexical block; see *Note Block Structure::.

+ Beginning of a lexical block; see *note Block Structure::.

`0xc2 N_EXCL'

- Place holder for a deleted include file; see *Note Include Files::.

+ Place holder for a deleted include file; see *note Include Files::.

`0xc4 N_SCOPE'

- Modula2 scope information (Sun linker); see *Note N_SCOPE::.

+ Modula2 scope information (Sun linker); see *note N_SCOPE::.

`0xe0 N_RBRAC'

- End of a lexical block; see *Note Block Structure::.

+ End of a lexical block; see *note Block Structure::.

`0xe2 N_BCOMM'

- Begin named common block; see *Note Common Blocks::.

+ Begin named common block; see *note Common Blocks::.

`0xe4 N_ECOMM'

- End named common block; see *Note Common Blocks::.

+ End named common block; see *note Common Blocks::.

`0xe8 N_ECOML'

- Member of a common block; see *Note Common Blocks::.

+ Member of a common block; see *note Common Blocks::.

`0xea N_WITH'

Pascal `with' statement: type,,0,0,offset (Solaris2).

`0xf0 N_NBTEXT'

- Gould non-base registers; see *Note Gould::.