Indexing m and n complete.
[dwarf-doc.git] / dwarf5 / latexdoc / dataobject.tex
index ed151e7..4b392c9 100644 (file)
@@ -11,7 +11,9 @@ a common \livelink{chap:commonblockentry}{block}.
 \label{chap:dataobjectentries}
 \addtoindexx{data object entries}
 
-Program variables, formal parameters and constants are
+Program variables, 
+\addtoindexx{formal parameter entry}
+formal parameters and constants are
 represented by debugging information entries with the tags
 \livetarg{chap:DWTAGvariable}{DW\-\_TAG\-\_variable}\addtoindexx{variable entry}, 
 \livetarg{chap:DWTAGformalparameter}{DW\-\_TAG\-\_formal\-\_parameter}\addtoindexx{formal parameter entry} and 
@@ -24,7 +26,9 @@ have true named constants.}
 The debugging information entry for a program variable,
 formal parameter or constant may have the following attributes:
 \begin{enumerate}[1.]
-\item A \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute, whose value is a null-terminated
+\item A \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute,
+\addtoindexx{name attribute}
+whose value is a null-terminated
 string, containing the data object name as it appears in the
 source program.  If a variable entry describes 
 an 
@@ -34,7 +38,9 @@ zero byte.
 
 \item A \livelink{chap:DWATexternal}{DW\-\_AT\-\_external} attribute, 
 \hypertarget{chap:DWATexternalexternalvariable}
-which is a \livelink{chap:flag}{flag}, if the name
+which 
+\addtoindexx{external attribute}
+is a \livelink{chap:flag}{flag}, if the name
 of a variable is visible outside of its enclosing compilation
 unit.  The definitions of C++ static data members of structures
 or classes are represented by variable entries \nolink{flagged} as
@@ -47,7 +53,9 @@ which is a \livelink{chap:flag}{flag} that
 indicates whether this entry represents a non-defining
 declaration of an object.
 
-\item A \livelink{chap:DWATlocation}{DW\-\_AT\-\_location} attribute, whose value describes the
+\item A \livelink{chap:DWATlocation}{DW\-\_AT\-\_location} attribute,
+\addtoindexx{location attribute}
+whose value describes the
 location of a variable or parameter at run-time.  In a variable
 entry representing the definition of a variable (that is,
 \addtoindexx{declaration attribute}
@@ -102,12 +110,16 @@ value in the calling function cannot be modified by the callee.
 
 \item A \livelink{chap:DWATisoptional}{DW\-\_AT\-\_is\-\_optional} attribute, 
 \hypertarget{chap:DWATisoptionaloptionalparameter}
-which is a \livelink{chap:flag}{flag}, if a
+which 
+\addtoindexx{is optional attribute}
+is a \livelink{chap:flag}{flag}, if a
 parameter entry represents an optional parameter.
 
 \item A \livelink{chap:DWATdefaultvalue}{DW\-\_AT\-\_default\-\_value} attribute 
 \addtoindexx{default value attribute}
-for a formal parameter
+for 
+\addtoindexx{formal parameter entry!with default value}
+a formal parameter
 \hypertarget{chap:DWATdefaultvaluedefaultvalueofparameter}
 entry. The value of this attribute is a reference to the
 debugging information entry for a variable or subroutine,
@@ -255,19 +267,25 @@ Section \refersec{chap:linkagenames}.
 \section{Common Block Entries}
 \label{chap:commonblockentries}
 A Fortran \livetargi{chap:fortrancommonblock}{common}{Fortran!common block} \livetargi{chap:commonblockentry}{block}{common block entry} 
-may be described by a debugging
+may 
+\addtoindexx{Fortran!common block}
+be described by a debugging
 information entry with the 
 tag \livetarg{chap:DWTAGcommonblock}{DW\-\_TAG\-\_common\-\_block}. 
 The
 common \nolink{block} 
-entry has a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute whose value
+entry has a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute 
+\addtoindexx{name attribute}
+whose value
 is a null-terminated string containing the 
 \livetargi{chap:commonblockreferenceattribute}{common}{common block reference attribute} \nolink{block}
 name as it appears in the source program. It may also have a
 \livelink{chap:DWATlinkagename}{DW\-\_AT\-\_linkage\-\_name} attribute as described in 
 Section \refersec{chap:linkagenames}. 
 It
-also has a \livelink{chap:DWATlocation}{DW\-\_AT\-\_location} attribute whose value describes the
+also has a \livelink{chap:DWATlocation}{DW\-\_AT\-\_location} attribute
+\addtoindexx{location attribute}
+whose value describes the
 location of the beginning of the common \nolink{block}. The common
 \nolink{block} entry owns debugging information entries describing
 the variables contained within the common \nolink{block}.
@@ -282,8 +300,11 @@ as a replacement for the list of names in various contexts.}
 A namelist is represented by a debugging information entry
 with the 
 tag \livetarg{chap:DWTAGnamelist}{DW\-\_TAG\-\_namelist}. 
+\addtoindexx{namelist entry}
 If the namelist itself has a
-name, the namelist entry has a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute, whose
+name, the namelist entry has a \livelink{chap:DWATname}{DW\-\_AT\-\_name} attribute,
+\addtoindexx{name attribute}
+whose
 value is a null-terminated string containing the namelist’s
 name as it appears in the source program.
 
@@ -293,12 +314,18 @@ name that is part of the namelist is represented
 by a debugging information entry with the tag
 \livetarg{chap:DWTAGnamelistitem}{DW\-\_TAG\-\_namelist\-\_item}. 
 Each such entry is a child of the
-namelist entry, and all of the namelist item entries for a
+namelist entry, and all of the 
+namelist item entries for a
+\addtoindexx{namelist item entry}
 given namelist are ordered as were the list of names they
 correspond to in the source program.
 
-Each namelist item entry contains a \livelink{chap:DWATnamelistitem}{DW\-\_AT\-\_namelist\-\_item}
-attribute whose value is a reference to the debugging
+Each namelist item entry contains a 
+\livelink{chap:DWATnamelistitem}{DW\-\_AT\-\_namelist\-\_item} attribute
+\addtoindexx{namelist item attribute}
+whose 
+\addtoindexx{namelist item entry}
+value is a reference to the debugging
 information entry representing the declaration of the item
 whose name appears in the namelist.