Save current working version in preparation for some largish changes.
authorRon Brender <ron.brender@gmail.com>
Mon, 29 Jun 2015 19:30:08 +0000 (15:30 -0400)
committerRon Brender <ron.brender@gmail.com>
Mon, 29 Jun 2015 19:30:08 +0000 (15:30 -0400)
Signed-off-by: Ron Brender <ron.brender@gmail.com>
dwarf5/latexdoc/changesummary.tex
dwarf5/latexdoc/dataobject.tex
dwarf5/latexdoc/datarepresentation.tex
dwarf5/latexdoc/dwarf5.tex
dwarf5/latexdoc/generaldescription.tex
dwarf5/latexdoc/otherdebugginginformation.tex
dwarf5/latexdoc/programscope.tex
dwarf5/latexdoc/splitobjects.tex

index f53c4ec..8603035 100644 (file)
@@ -15,6 +15,8 @@ This change summary is included only in draft versions of this document.
 \begin{longtable}{ll}
 \textbf{Date}  & \textbf{Issue Incorporated or Other Change}   \\ \hline       \\
 \endhead
+6/24-29/2015    & More editorial work VIII \\
+6/24/2015       & 150608.1 (DW\_AT\_dwo\_id value implementation-defined) \\
 6/14-20/2015    & More editorial work VII \\
 6/8-13/2015     & More editorial work VI (release to committee) \\
 6/5-7/2015      & Add \definition{color} to defining occurrence(s) of DWARF names.  \\
index 36b6666..30e834e 100644 (file)
@@ -313,7 +313,7 @@ entry has a \DWATname{} attribute
 \addtoindexx{name attribute}
 whose value is a null-terminated
 string containing the
-\livetargi{chap:commonblockreferenceattribute}{common \nolink{block}}{common block reference attribute} 
+\livetargi{chap:commonblockreferenceattribute}{common block}{common block reference attribute} 
 name as it appears in the source program. It may also have a
 \DWATlinkagename{} attribute as described in 
 Section \refersec{chap:linkagenames}. 
index 93b3987..d7631cc 100644 (file)
@@ -174,7 +174,7 @@ the virtual address space of the program, and require relocation.
 These attributes refer to
 debugging information in other debugging information sections within
 the object file, and must be relocated during the linking process.
-
+\par
 However, if a \DWATrangesbase{} attribute is present, the offset in
 a \DWATranges{} attribute (which uses form \DWFORMsecoffset) is
 relative to the given base offset--no relocation is involved.
@@ -288,7 +288,7 @@ The full compilation unit, in the \dotdebuginfodwo{} section.
 \begin{itemize}
 \item
 The full compilation unit entry includes a \DWATdwoid{} 
-attribute whose value is the same as that of the \DWATdwoid{} 
+attribute whose form and value is the same as that of the \DWATdwoid{} 
 attribute of the associated skeleton unit.
 \needlines{4}
 \item
@@ -344,7 +344,7 @@ executable object are virtual addresses.
 
 \needlines{6}
 \subsection{Shared Object Files}
-\label{datarep:sharedobject Files}
+\label{datarep:sharedobjectfiles}
 The relocated
 addresses in the debugging information for a shared object file
 are offsets relative to the start of the lowest region of
@@ -2889,14 +2889,14 @@ The name index attributes and their encodings are listed in Table \referfol{data
 \setlength{\extrarowheight}{0.1cm}
 \begin{longtable}{l|c|l}
   \caption{Name index attribute encodings} \label{datarep:indexattributeencodings}\\
-  \hline \bfseries Attribute name&\bfseries Value &\bfseries Form/Class \\ \hline
+  \hline \bfseries Attribute name &\bfseries Value &\bfseries Form/Class \\ \hline
 \endfirsthead
-  \bfseries Attribute name&\bfseries Value &\bfseries Form/Class \\ \hline
+  \bfseries Attribute name &\bfseries Value &\bfseries Form/Class \\ \hline
 \endhead
   \hline \emph{Continued on next page}
 \endfoot
   \hline
-  \ddag \ \textit{New in \DWARFVersionV}
+  \ddag~\textit{New in \DWARFVersionV}
 \endlastfoot
 \DWIDXcompileunit~\ddag & 1        & \CLASSconstant \\
 \DWIDXtypeunit~\ddag    & 2        & \CLASSconstant \\
index ca350d3..efdbaf1 100644 (file)
@@ -3,7 +3,7 @@
 % If draft is in the document class list, pix are just suggested
 % by an outline, the pic does not appear as a picture.
 %
-\newcommand{\docdate}{June 20, 2015}
+\newcommand{\docdate}{June 29, 2015}
 %
 \usepackage{ifthen}
 \newboolean{isdraft}
@@ -322,7 +322,7 @@ escapeinside={\%*}{*)}     % if you want to add a comment within your code
 \include{otherdebugginginformation}    \emptypage
 \include{datarepresentation}            \emptypage
 
-%  The \appendix toggles us into appendix chapters
+%  The \appendix command toggles us into appendix chapters
 \appendix
 
 \include{attributesbytag}              %\emptypage
@@ -333,6 +333,8 @@ escapeinside={\%*}{*)}     % if you want to add a comment within your code
 \include{splitobjects}                 %\emptypage
 \include{sectionversionnumbers}         \emptypage
 \include{gnulicense}                    \emptypage
+%\include{selectedglossary}              %\emptypage
+%\include{unitattributecomparison}
 
 \printindex
 
index 31f1bb4..b423654 100644 (file)
@@ -156,15 +156,24 @@ The attributes are listed in Table \referfol{tab:attributenames}.
 
 \setlength{\extrarowheight}{0.1cm}
 \addtoindexx{attributes!list of}
-\begin{longtable}{l|P{9cm}}
+\begin{longtable}{P{6.2cm}|P{8.5cm}}
   \caption{Attribute names} \label{tab:attributenames} \\
-  \hline \bfseries Attribute&\bfseries Identifies or Specifies \\ \hline
+  \hline \bfseries Attribute$^*$&\bfseries Identifies or Specifies \\ \hline
 \endfirsthead
-  \bfseries Attribute&\bfseries Identifies or Specifies \\ \hline
+  \bfseries Attribute$^*$&\bfseries Identifies or Specifies \\ \hline
 \endhead
-  \hline \emph{Continued on next page}
+  \hline
+  \multicolumn{2}{l}{
+  \parbox{15cm}{
+  \vspace{2mm}\emph{Continued on next page} \newline
+  $^*${\parbox[t]{15cm}{\tiny Links for attributes come to the left column of this table;
+  links in the right column "fan-out" to one or more descriptions.}} \newline
+  ~\newline}}
 \endfoot
   \hline
+  \multicolumn{2}{l}{
+  $^*${\parbox[t]{15cm}{\tiny Links for attributes come to the left column of this table;
+  links in the right column "fan-out" to one or more descriptions.}}}
 \endlastfoot
 
 \DWATabstractoriginTARG
index f2e5be8..fa7716f 100644 (file)
@@ -1625,8 +1625,9 @@ All other flags are reserved by DWARF.
 
 \item \addttindex{debug\_line\_offset} \\
 An offset in the \dotdebugline{} section of the
-beginning of the line number information, encoded as 4-byte offset for
-a 32-bit DWARF format macro section and 8-byte offset for a 64-bit DWARF format
+beginning of the line number information in the containing
+compilation, encoded as a 4-byte offset for a 32-bit DWARF 
+format macro section and an 8-byte offset for a 64-bit DWARF format
 macro section.  
 
 \item \addttindex{opcode\_operands\_table} \\
@@ -2144,16 +2145,16 @@ any \dotdebuginfo{} section, the augmentation string always uses
 UTF\dash 8 encoding.}
 
 \needlines{4}
-\item  \HFNaddresssize{} (\HFTubyte) \\
+\item \HFNaddresssize{} (\HFTubyte) \\
 The size of a target address in this CIE and any FDEs that
 use it, in bytes. If a compilation unit exists for this frame,
 its address size must match the address size here.
 
-\item  \HFNsegmentselectorsize{} (\HFTubyte) \\
+\item \HFNsegmentselectorsize{} (\HFTubyte) \\
 The size of a segment selector in this CIE and any FDEs that
 use it, in bytes.
 
-\item  \HFNcodealignmentfactor{} (unsigned LEB128) 
+\item \HFNcodealignmentfactor{} (unsigned LEB128) 
 \addtoindexx{LEB128!unsigned}\addtoindexx{unsigned LEB128|see{LEB128, unsigned}}
 \addtoindexx{code alignment factor} \\
 A 
index e7d2cb3..cf9ebcb 100644 (file)
@@ -106,9 +106,7 @@ of the machine instructions generated for the compilation
 unit (see Section \refersec{chap:codeaddressesandranges}).
   
 A \DWATlowpc{} attribute 
-may also
-be specified 
-in combination 
+may also be specified in combination 
 \addtoindexx{ranges attribute}
 with 
 \DWATranges{} to specify the
@@ -370,7 +368,7 @@ Indirect string references
 interpreted as indices relative to this base.
 
 \needlines{6}
-\item A \DWATaddrbaseTARG\addtoindexx{address table base attribute}
+\item A \DWATaddrbaseDEFN\addtoindexx{address table base attribute}
 \hypertarget{chap:DWATaddrbaseforaddresstable}{}
 attribute, whose value is of class \CLASSaddrptr.
 This attribute points to the beginning of the compilation
@@ -442,11 +440,14 @@ compilation unit.
 
 \item
 \livetarg{chap:DWATdwoidforunit}{}
-A \DWATdwoidDEFN{} attribute\addtoindexx{unit signature attribute}
-whose value is an 8-byte
-unsigned hash of the full compilation unit.  This hash
-value is computed by the method described in 
-Section \refersec{datarep:typesignaturecomputation}.
+A \DWATdwoidDEFN{} attribute\addtoindexx{unit identification attribute}
+whose implementation-defined integer constant value
+provides unique identification of this compilation unit
+as well as the associated compilation unit in the
+split DWARF object file named in the \DWATdwoname{}
+attribute. For simplicity, the skeleton compilation
+unit and the split DWARF object file must use the same
+form to encode this identification value.
 
 \needlines{6}
 \item
@@ -521,14 +522,6 @@ language used to define the type. The set of language names
 and their meanings are given in Table \refersec{tab:languagenames}.
 
 \needlines{4}
-\item A 
-\DWATstroffsetsbase\addtoindexx{string base offset attribute}
-attribute, whose value is a reference. This attribute points
-to the first string offset of the type unit's contribution to
-the \dotdebugstroffsets{} section. Indirect string references
-(using \DWFORMstrx) within the type unit are interpreted
-as indices relative to this base.
-
 \item A \DWATstmtlist{} attribute\addtoindexx{statement list attribute}
 whose value of class \CLASSlineptr{} points to the line number 
 information for this type unit.
@@ -544,11 +537,12 @@ type unit entries can simply refer to the line number table
 used by the compilation unit. 
 \item In a \splitDWARFobjectfile, where
 the type units are located in a separate DWARF object file,
-the \DWATstmtlist{} attribute refers to a "specialized"
+the \DWATstmtlistNAME{} attribute refers to a "specialized"
 line number table in the \dotdebuglinedwo{} section, which
 contains only the list of directories and file names. All
-type unit entries in a \splitDWARFobjectfile{} may (but are not
-required to) refer to the same \addtoindex{specialized line number table}.
+type unit entries in a \splitDWARFobjectfile{} may (but are 
+not required to) refer to the same 
+\addtoindex{specialized line number table}.
 \end{itemize}
 
 \item A \DWATuseUTFeight{} attribute, which is a flag
@@ -557,6 +551,14 @@ unit entry, its children, and its associated
 \addtoindex{specialized line number table}, 
 are represented using the UTF-8 representation.
 
+\item A 
+\DWATstroffsetsbase\addtoindexx{string base offset attribute}
+attribute, whose value is a reference. This attribute points
+to the first string offset of the type unit's contribution to
+the \dotdebugstroffsets{} section. Indirect string references
+(using \DWFORMstrx) within the type unit are interpreted
+as indices relative to this base.
+
 \end{enumerate}
 
 A \addtoindex{type unit} entry for a given type T owns a debugging
@@ -2343,7 +2345,7 @@ the with statement.
 \needlines{6}
 \section{Try and Catch Block Entries}
 \label{chap:tryandcatchblockentries}
-\livetargi{chap:tryandcatchblockentries}{}
+\livetarg{chap:tryandcatchblockentries}{}
 \textit{In \addtoindex{C++}, a \livelink{chap:lexicalblock}{lexical block} may be 
 designated as a \doublequote{catch \nolink{block}.} 
 A catch \nolink{block} is an exception handler that 
@@ -2372,7 +2374,7 @@ a
 \DWATranges{} attribute 
 \addtoindexx{ranges attribute}
 whose values encode the contiguous
-or non\dash contiguous address ranges, respectively, of the
+or non-contiguous address ranges, respectively, of the
 machine instructions generated for the \nolink{block}
 (see Section \refersec{chap:codeaddressesandranges}).
 
@@ -2394,7 +2396,7 @@ that catch \nolink{block}.
 This child entry has one of the tags
 \DWTAGformalparameter{}\addtoindexx{formal parameter entry!in catch block}
 or
-\DWTAGunspecifiedparameters,\addtoindexx{unspecified parameters entry!in catch block}
+\DWTAGunspecifiedparameters{},\addtoindexx{unspecified parameters entry!in catch block}
 and will have the same form as other parameter entries.
 
 The siblings immediately following a try \nolink{block} 
index 2d853f1..d9f4b2f 100644 (file)
@@ -201,7 +201,7 @@ References from \DWTAGcompileunit{} DIEs to the
 remains in the skeleton \dotdebuginfo{} section, so no
 relocation in the \dotdebuginfodwo{} section is necessary.
 \item
-References from \DWTAGtypeunit{} DIEs to the skeleton
+References from \DWTAGtypeunit{} DIEs to the 
 \dotdebuglinedwo{} section, via \DWATstmtlist{}. Because the new
 sections are not combined at link time, these references need
 no relocations.