Links for DW_ATE and DW_ADDR added in.
authorDavid Anderson <davea42@earthlink.net>
Thu, 31 May 2012 20:55:01 +0000 (13:55 -0700)
committerDavid Anderson <davea42@earthlink.net>
Thu, 31 May 2012 20:55:01 +0000 (13:55 -0700)
dwarf5/latexdoc/compression.tex
dwarf5/latexdoc/datarepresentation.tex
dwarf5/latexdoc/examples.tex
dwarf5/latexdoc/generaldescription.tex
dwarf5/latexdoc/typeentries.tex

index e6936f0..7a60f23 100644 (file)
@@ -624,7 +624,7 @@ Section \refersec{app:duplicateeliminationexample2companiondwarf}.
         \livelink{chap:DWATname}{DW\-\_AT\-\_name}(F90\$main)
         \livelink{chap:DWTAGbasetype}{DW\-\_TAG\-\_base\-\_type}
             \livelink{chap:DWATname}{DW\-\_AT\-\_name}("INTEGER")
-            \livelink{chap:DWATencoding}{DW\-\_AT\-\_encoding}(DW\-\_ATE\-\_signed)
+            \livelink{chap:DWATencoding}{DW\-\_AT\-\_encoding}(\livelink{chap:DWATEsigned}{DW\-\_ATE\-\_signed})
             \livelink{chap:DWATbytesize}{DW\-\_AT\-\_byte\-\_size}(...)
 
         \livelink{chap:DWTAGbasetype}{DW\-\_TAG\-\_base\-\_type}
@@ -771,7 +771,7 @@ L1:
 L2:
      \livelink{chap:DWTAGbasetype}{DW\-\_TAG\-\_base\-\_type}
          \livelink{chap:DWATbytesize}{DW\-\_AT\-\_byte\-\_size} : 4
-         \livelink{chap:DWATencoding}{DW\-\_AT\-\_encoding} : DW\-\_ATE\-\_signed
+         \livelink{chap:DWATencoding}{DW\-\_AT\-\_encoding} : \livelink{chap:DWATEsigned}{DW\-\_ATE\-\_signed}
          \livelink{chap:DWATname}{DW\-\_AT\-\_name} : "int"
 \end{alltt}
 
@@ -809,7 +809,7 @@ Section \refersec{app:typesignaturecomputation1flattenedbytestream}.
         0x41 0x03 0x08 0x69 0x6e 0x74 0x00
         // Step 4: 'A' \livelink{chap:DWATbytesize}{DW\-\_AT\-\_byte\-\_size} \livelink{chap:DWFORMsdata}{DW\-\_FORM\-\_sdata} 4
         0x41 0x0b 0x0d 0x04
-        // Step 4: 'A' \livelink{chap:DWATencoding}{DW\-\_AT\-\_encoding} \livelink{chap:DWFORMsdata}{DW\-\_FORM\-\_sdata} DW\-\_ATE\-\_signed
+        // Step 4: 'A' \livelink{chap:DWATencoding}{DW\-\_AT\-\_encoding} \livelink{chap:DWFORMsdata}{DW\-\_FORM\-\_sdata} \livelink{chap:DWATEsigned}{DW\-\_ATE\-\_signed}
         0x41 0x3e 0x0d 0x05
         // Step 7: End of \livelink{chap:DWTAGbasetype}{DW\-\_TAG\-\_base\-\_type} "int"
         0x00
@@ -905,7 +905,7 @@ L1:
 L2:
     \livelink{chap:DWTAGbasetype}{DW\-\_TAG\-\_base\-\_type}
          \livelink{chap:DWATbytesize}{DW\-\_AT\-\_byte\-\_size} : 4
-         \livelink{chap:DWATencoding}{DW\-\_AT\-\_encoding} : DW\-\_ATE\-\_signed
+         \livelink{chap:DWATencoding}{DW\-\_AT\-\_encoding} : \livelink{chap:DWATEsigned}{DW\-\_ATE\-\_signed}
          \livelink{chap:DWATname}{DW\-\_AT\-\_name} : "int"
 L3:
     \livelink{chap:DWTAGpointertype}{DW\-\_TAG\-\_pointer\-\_type}
@@ -973,7 +973,7 @@ Section \refersec{app:typesignatureexample2flattenedbytestream}.
         0x41 0x03 0x08 0x69 0x6e 0x74 0x00
         // Step 4: 'A' \livelink{chap:DWATbytesize}{DW\-\_AT\-\_byte\-\_size} \livelink{chap:DWFORMsdata}{DW\-\_FORM\-\_sdata} 4
         0x41 0x0b 0x0d 0x04
-        // Step 4: 'A' \livelink{chap:DWATencoding}{DW\-\_AT\-\_encoding} \livelink{chap:DWFORMsdata}{DW\-\_FORM\-\_sdata} DW\-\_ATE\-\_signed
+        // Step 4: 'A' \livelink{chap:DWATencoding}{DW\-\_AT\-\_encoding} \livelink{chap:DWFORMsdata}{DW\-\_FORM\-\_sdata} \livelink{chap:DWATEsigned}{DW\-\_ATE\-\_signed}
         0x41 0x3e 0x0d 0x05
         // Step 7: End of \livelink{chap:DWTAGbasetype}{DW\-\_TAG\-\_base\-\_type} "int"
         0x00
index ef560dd..12084e0 100644 (file)
@@ -1265,24 +1265,24 @@ Table \refersec{tab:basetypeencodingvalues}
   \hline
 \endlastfoot
 
-DW\-\_ATE\-\_address&0x01 \\
-DW\-\_ATE\-\_boolean&0x02 \\
-DW\-\_ATE\-\_complex\-\_float&0x03 \\
-DW\-\_ATE\-\_float&0x04 \\
-DW\-\_ATE\-\_signed&0x05 \\
-DW\-\_ATE\-\_signed\-\_char&0x06 \\
-DW\-\_ATE\-\_unsigned&0x07 \\
-DW\-\_ATE\-\_unsigned\-\_char&0x08 \\
-DW\-\_ATE\-\_imaginary\-\_float&0x09 \\
-DW\-\_ATE\-\_packed\-\_decimal&0x0a \\
-DW\-\_ATE\-\_numeric\-\_string&0x0b \\
-DW\-\_ATE\-\_edited&0x0c \\
-DW\-\_ATE\-\_signed\-\_fixed&0x0d \\
-DW\-\_ATE\-\_unsigned\-\_fixed&0x0e \\
-DW\-\_ATE\-\_decimal\-\_float & 0x0f \\
-DW\-\_ATE\-\_UTF \ddag & 0x10 \\
-DW\-\_ATE\-\_lo\-\_user & 0x80 \\
-DW\-\_ATE\-\_hi\-\_user & 0xff \\
+\livelink{chap:DWATEaddress}{DW\-\_ATE\-\_address}&0x01 \\
+\livelink{chap:DWATEboolean}{DW\-\_ATE\-\_boolean}&0x02 \\
+\livelink{chap:DWATEcomplexfloat}{DW\-\_ATE\-\_complex\-\_float}&0x03 \\
+\livelink{chap:DWATEfloat}{DW\-\_ATE\-\_float}&0x04 \\
+\livelink{chap:DWATEsigned}{DW\-\_ATE\-\_signed}&0x05 \\
+\livelink{chap:DWATEsignedchar}{DW\-\_ATE\-\_signed\-\_char}&0x06 \\
+\livelink{chap:DWATEunsigned}{DW\-\_ATE\-\_unsigned}&0x07 \\
+\livelink{chap:DWATEunsignedchar}{DW\-\_ATE\-\_unsigned\-\_char}&0x08 \\
+\livelink{chap:DWATEimaginaryfloat}{DW\-\_ATE\-\_imaginary\-\_float}&0x09 \\
+\livelink{chap:DWATEpackeddecimal}{DW\-\_ATE\-\_packed\-\_decimal}&0x0a \\
+\livelink{chap:DWATEnumericstring}{DW\-\_ATE\-\_numeric\-\_string}&0x0b \\
+\livelink{chap:DWATEedited}{DW\-\_ATE\-\_edited}&0x0c \\
+\livelink{chap:DWATEsignedfixed}{DW\-\_ATE\-\_signed\-\_fixed}&0x0d \\
+\livelink{chap:DWATEunsignedfixed}{DW\-\_ATE\-\_unsigned\-\_fixed}&0x0e \\
+\livelink{chap:DWATEdecimalfloat}{DW\-\_ATE\-\_decimal\-\_float} & 0x0f \\
+\livelink{chap:DWATEUTF}{DW\-\_ATE\-\_UTF} \ddag & 0x10 \\
+\livetarg{chap:DWATElouser}{DW\-\_ATE\-\_lo\-\_user} & 0x80 \\
+\livetarg{chap:DWATEhiuser}{DW\-\_ATE\-\_hi\-\_user} & 0xff \\
 
 \end{longtable}
 \ddag  Base type encoding new in DWARF Version 4
@@ -1491,7 +1491,7 @@ DW\-\_LANG\-\_hi\-\_user&0xffff & \\
 \label{datarep:addressclassencodings}
 
 The value of the common address class encoding 
-DW\-\_ADDR\-\_none is 0.
+\livelink{chap:DWADDRnone}{DW\-\_ADDR\-\_none} is 0.
 
 
 \section{Identifier Case}
index 180a2bb..907a3cd 100644 (file)
@@ -56,7 +56,7 @@ DW\-\_LANG\-\_C89
 \hrule
 2
 “char”
-DW\-\_ATE\-\_unsigned\-\_char
+\livelink{chap:DWATEunsignedchar}{DW\-\_ATE\-\_unsigned\-\_char}
 1
 \vspace{0.01cm}
 \hrule
@@ -1792,11 +1792,11 @@ char32_t chr_b = U'h';
 !
 1\$: \livelink{chap:DWTAGbasetype}{DW\-\_TAG\-\_base\-\_type}
         \livelink{chap:DWATname}{DW\-\_AT\-\_name}("char16\_t")
-        \livelink{chap:DWATencoding}{DW\-\_AT\-\_encoding}(DW\-\_ATE\-\_UTF)
+        \livelink{chap:DWATencoding}{DW\-\_AT\-\_encoding}(\livelink{chap:DWATEUTF}{DW\-\_ATE\-\_UTF})
         \livelink{chap:DWATbytesize}{DW\-\_AT\-\_byte\-\_size}(2)
 2\$: \livelink{chap:DWTAGbasetype}{DW\-\_TAG\-\_base\-\_type}
         \livelink{chap:DWATname}{DW\-\_AT\-\_name}("char32\_t")
-        \livelink{chap:DWATencoding}{DW\-\_AT\-\_encoding}(DW\-\_ATE\-\_UTF)
+        \livelink{chap:DWATencoding}{DW\-\_AT\-\_encoding}(\livelink{chap:DWATEUTF}{DW\-\_ATE\-\_UTF})
         \livelink{chap:DWATbytesize}{DW\-\_AT\-\_byte\-\_size}(4)
 3\$: \livelink{chap:DWTAGvariable}{DW\-\_TAG\-\_variable}
         \livelink{chap:DWATname}{DW\-\_AT\-\_name}("chr\_a")
index ad40be6..e9b4896 100644 (file)
@@ -1493,7 +1493,8 @@ Any debugging information entry representing a pointer or
 reference type or a subroutine or subroutine type may have
 a \livelink{chap:DWATaddressclass}{DW\-\_AT\-\_address\-\_class} attribute, whose value is an integer
 constant.  The set of permissible values is specific to
-each target architecture. The value DW\-\_ADDR\-\_none, however,
+each target architecture. The value \livetarg{chap:DWADDRnone}{DW\-\_ADDR\-\_none}, 
+however,
 is common to all encodings, and means that no address class
 has been specified.
 
index 94289a3..b078b2b 100644 (file)
@@ -49,7 +49,7 @@ a value of the type.
 \textit{For example, the C type int on a machine that uses 32\dash bit
 integers is represented by a base type entry with a name
 attribute whose value is “int”, an encoding attribute
-whose value is DW\-\_ATE\-\_signed and a byte size attribute whose
+whose value is \livelink{chap:DWATEsigned}{DW\-\_ATE\-\_signed} and a byte size attribute whose
 value is 4.}
 
 If the value of an object of the given type does not fully
@@ -123,42 +123,42 @@ DWARF V3 defines the following combinations:
 \centering
 \begin{tabular}{lp{9cm}}
 Name&Meaning\\ \hline
-DW\-\_ATE\-\_address &  linear machine address (for
+\livetarg{chap:DWATEaddress}{DW\-\_ATE\-\_address} &  linear machine address (for
   segmented addresses see
   Section \refersec{chap:segmentedaddresses}) \\
-DW\-\_ATE\-\_boolean& true or false \\
-
-DW\-\_ATE\-\_complex\-\_float& complex binary floating\dash point number \\
-DW\-\_ATE\-\_float & binary floating\dash point number \\
-DW\-\_ATE\-\_imaginary\-\_float& imaginary binary floating\dash point number \\
-DW\-\_ATE\-\_signed& signed binary integer \\
-DW\-\_ATE\-\_signed\-\_char& signed character \\
-DW\-\_ATE\-\_unsigned & unsigned binary integer \\
-DW\-\_ATE\-\_unsigned\-\_char & unsigned character \\
-DW\-\_ATE\-\_packed\-\_decimal  & packed decimal \\
-DW\-\_ATE\-\_numeric\-\_string& numeric string \\
-DW\-\_ATE\-\_edited & edited string \\
-DW\-\_ATE\-\_signed\-\_fixed & signed fixed\dash point scaled integer \\
-DW\-\_ATE\-\_unsigned\-\_fixed& unsigned fixed\dash point scaled integer \\
-DW\-\_ATE\-\_decimal\-\_float & decimal floating\dash point number \\ 
-DW\-\_ATE\-\_UTF & Unicode character \\
+\livetarg{chap:DWATEboolean}{DW\-\_ATE\-\_boolean}& true or false \\
+
+\livetarg{chap:DWATEcomplexfloat}{DW\-\_ATE\-\_complex\-\_float}& complex binary floating\dash point number \\
+\livetarg{chap:DWATEfloat}{DW\-\_ATE\-\_float} & binary floating\dash point number \\
+\livetarg{chap:DWATEimaginaryfloat}{DW\-\_ATE\-\_imaginary\-\_float}& imaginary binary floating\dash point number \\
+\livetarg{chap:DWATEsigned}{DW\-\_ATE\-\_signed}& signed binary integer \\
+\livetarg{chap:DWATEsignedchar}{DW\-\_ATE\-\_signed\-\_char}& signed character \\
+\livetarg{chap:DWATEunsigned}{DW\-\_ATE\-\_unsigned} & unsigned binary integer \\
+\livetarg{chap:DWATEunsignedchar}{DW\-\_ATE\-\_unsigned\-\_char} & unsigned character \\
+\livetarg{chap:DWATEpackeddecimal}{DW\-\_ATE\-\_packed\-\_decimal}  & packed decimal \\
+\livetarg{chap:DWATEnumericstring}{DW\-\_ATE\-\_numeric\-\_string}& numeric string \\
+\livetarg{chap:DWATEedited}{DW\-\_ATE\-\_edited} & edited string \\
+\livetarg{chap:DWATEsignedfixed}{DW\-\_ATE\-\_signed\-\_fixed} & signed fixed\dash point scaled integer \\
+\livetarg{chap:DWATEunsignedfixed}{DW\-\_ATE\-\_unsigned\-\_fixed}& unsigned fixed\dash point scaled integer \\
+\livetarg{chap:DWATEdecimalfloat}{DW\-\_ATE\-\_decimal\-\_float} & decimal floating\dash point number \\ 
+\livetarg{chap:DWATEUTF}{DW\-\_ATE\-\_UTF} & Unicode character \\
 \end{tabular}
 \caption{Encoding attribute values}
 \label{fig:encodingattributevalues}
 \end{figure}
 
-\textit{The DW\-\_ATE\-\_decimal\-\_float encoding is intended for
+\textit{The \livelink{chap:DWATEdecimalfloat}{DW\-\_ATE\-\_decimal\-\_float} encoding is intended for
 floating\dash point representations that have a power\dash of\dash ten
 exponent, such as that specified in IEEE 754R.}
 
-\textit{The DW\-\_ATE\-\_UTF encoding is intended for Unicode string
+\textit{The \livelink{chap:DWATEUTF}{DW\-\_ATE\-\_UTF} encoding is intended for Unicode string
 encodings (see the Universal Character Set standard,
 ISO/IEC 10646\dash 1:1993). For example, the C++ type char16\_t is
 represented by a base type entry with a name attribute whose
 value is “char16\_t”, an encoding attribute whose value
-is DW\-\_ATE\-\_UTF and a byte size attribute whose value is 2.}
+is \livelink{chap:DWATEUTF}{DW\-\_ATE\-\_UTF} and a byte size attribute whose value is 2.}
 
-The DW\-\_ATE\-\_packed\-\_decimal and DW\-\_ATE\-\_numeric\-\_string base types
+The \livelink{chap:DWATEpackeddecimal}{DW\-\_ATE\-\_packed\-\_decimal} and \livelink{chap:DWATEnumericstring}{DW\-\_ATE\-\_numeric\-\_string} base types
 represent packed and unpacked decimal string numeric data
 types, respectively, either of which may be either signed
 or unsigned. These base types are used in combination with
@@ -188,7 +188,7 @@ decimal point to the left; if the absolute value of the scale
 is larger than the digit count, this implies additional zero
 digits on the left are not stored in an instance of the type.
 
-The DW\-\_ATE\-\_edited base type is used to represent an edited
+The \livelink{chap:DWATEedited}{DW\-\_ATE\-\_edited} base type is used to represent an edited
 numeric or alphanumeric data type. It is used in combination
 with an \livelink{chap:DWATpicturestring}{DW\-\_AT\-\_picture\-\_string} attribute whose value is a 
 null\dash terminated string containing the target\dash dependent picture
@@ -197,8 +197,8 @@ string associated with the type.
 If the edited base type entry describes an edited numeric
 data type, the edited type entry has a \livelink{chap:DWATdigitcount}{DW\-\_AT\-\_digit\-\_count} and a
 \livelink{chap:DWATdecimalscale}{DW\-\_AT\-\_decimal\-\_scale} attribute. These attributes have the same
-interpretation as described for the DW\-\_ATE\-\_packed\-\_decimal and
-DW\-\_ATE\-\_numeric\-\_string base types. If the edited type entry
+interpretation as described for the \livelink{chap:DWATEpackeddecimal}{DW\-\_ATE\-\_packed\-\_decimal} and
+\livelink{chap:DWATEnumericstring}{DW\-\_ATE\-\_numeric\-\_string} base types. If the edited type entry
 describes an edited alphanumeric data type, the edited type
 entry does not have these attributes.
 
@@ -209,18 +209,18 @@ distinguish edited numeric from edited alphanumeric, although
 in principle the digit count and scale are derivable by
 interpreting the picture string.}
 
-The DW\-\_ATE\-\_signed\-\_fixed and DW\-\_ATE\-\_unsigned\-\_fixed entries
+The \livelink{chap:DWATEsignedfixed}{DW\-\_ATE\-\_signed\-\_fixed} and \livelink{chap:DWATEunsignedfixed}{DW\-\_ATE\-\_unsigned\-\_fixed} entries
 describe signed and unsigned fixed\dash point binary data types,
 respectively.
 
 The fixed binary type entries have a \livelink{chap:DWATdigitcount}{DW\-\_AT\-\_digit\-\_count}
 attribute with the same interpretation as described for the
-DW\-\_ATE\-\_packed\-\_decimal and DW\-\_ATE\-\_numeric\-\_string base types.
+\livelink{chap:DWATEpackeddecimal}{DW\-\_ATE\-\_packed\-\_decimal} and \livelink{chap:DWATEnumericstring}{DW\-\_ATE\-\_numeric\-\_string} base types.
 
 For a data type with a decimal scale factor, the fixed binary
 type entry has a \livelink{chap:DWATdecimalscale}{DW\-\_AT\-\_decimal\-\_scale} attribute with the same
-interpretation as described for the DW\-\_ATE\-\_packed\-\_decimal
-and DW\-\_ATE\-\_numeric\-\_string base types.
+interpretation as described for the \livelink{chap:DWATEpackeddecimal}{DW\-\_ATE\-\_packed\-\_decimal}
+and \livelink{chap:DWATEnumericstring}{DW\-\_ATE\-\_numeric\-\_string} base types.
 
 For a data type with a binary scale factor, the fixed
 binary type entry has a \livelink{chap:DWATbinaryscale}{DW\-\_AT\-\_binary\-\_scale} attribute. The