Final version...
authorRon Brender <ron.brender@gmail.com>
Mon, 13 Feb 2017 11:33:29 +0000 (06:33 -0500)
committerRon Brender <ron.brender@gmail.com>
Mon, 13 Feb 2017 11:33:29 +0000 (06:33 -0500)
Signed-off-by: Ron Brender <ron.brender@gmail.com>
dwarf5/latexdoc/changesummary.tex
dwarf5/latexdoc/datarepresentation.tex
dwarf5/latexdoc/dwarf5.tex
dwarf5/latexdoc/generaldescription.tex
dwarf5/latexdoc/otherdebugginginformation.tex
dwarf5/latexdoc/typeentries.tex

index bcc3d62..647beed 100644 (file)
@@ -15,6 +15,7 @@ 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
+2/12/2017       & Final tweaks \\
 2/3/2017        & 161027.1 (Case sensitive names), 161206.[123] (piece and bit piece), \\
                 & Final review draft \\
 1/24/2017       % Changes from meeting of 1/24/2017 \\
index a37a63a..0e832f9 100644 (file)
@@ -711,10 +711,14 @@ to import entries from the \addtoindex{supplementary object file}, other
 \bb
 \DWFORMrefsupfour{} or \DWFORMrefsupeight{}
 \eb
-attributes to refer to them and \DWFORMstrpsup{} form attributes to
+attributes to refer 
+\bb
+directly to individual entries in the supplementary file, 
+\eb
+and \DWFORMstrpsup{} form attributes to
 refer to strings that are used by debug information of multiple
 executables or shared object files.  Within the \addtoindex{supplementary object file}'s
-debugging sections, form 
+debugging sections, forms 
 \bb
 \DWFORMrefsupfour{}, \DWFORMrefsupeight{} 
 \eb
@@ -1862,7 +1866,7 @@ index into an array of addresses in the \dotdebugaddr{} section.
 The representation of a \DWFORMaddrxoneNAME, \DWFORMaddrxtwoNAME, 
 \DWFORMaddrxthreeNAME{} or \DWFORMaddrxfourNAME{} value is a 
 1-, 2-, 3- or 4-byte unsigned integer value, respectively,
-which is similarly interpretated.
+which is similarly interpreted.
 \eb
 The index is relative to the value of the \DWATaddrbase{} attribute 
 of the associated compilation unit.
@@ -2239,7 +2243,7 @@ index into an array of offsets in the \dotdebugstroffsets{} section.
 The representation of a \DWFORMstrxoneNAME, \DWFORMstrxtwoNAME, 
 \DWFORMstrxthreeNAME{} or \DWFORMstrxfourNAME{} value is a 
 1-, 2-, 3- or 4-byte unsigned integer value, respectively,
-which is similarly interpretated.
+which is similarly interpreted.
 \eb 
 The offset entries in the \dotdebugstroffsets{} section have the 
 same representation as \DWFORMstrp{} values.
@@ -3649,7 +3653,7 @@ If the \HFNoffsetentrycount{} is zero, then \DWFORMrnglistx{} cannot
 be used to access a range list; \DWFORMsecoffset{} must be used 
 instead. If the \HFNoffsetentrycount{} is non-zero, then \DWFORMrnglistx{} 
 may be used to access a range list; this is necessary in split units and
-otherwise may be more compact than using \DWFORMsecoffset.
+may be more compact than using \DWFORMsecoffset in non-split units.
 \eb
 }
 
@@ -3738,7 +3742,7 @@ If the \HFNoffsetentrycount{} is zero, then \DWFORMloclistx{} cannot
 be used to access a location list; \DWFORMsecoffset{} must be used 
 instead. If the \HFNoffsetentrycount{} is non-zero, then \DWFORMloclistx{} 
 may be used to access a location list; this is necessary in split units and
-otherwise may be more compact than using \DWFORMsecoffset.
+may be more compact than using \DWFORMsecoffset in non-split units.
 \eb
 }
 
index 4d76df5..6dba688 100644 (file)
@@ -3,11 +3,11 @@
 % 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}{February 3, 2017}
+\newcommand{\docdate}{February 13, 2017}
 %
 \usepackage{ifthen}
     \newcommand{\ifthen}[2]{\ifthenelse{#1}{#2}{}}
-    \newboolean{isdraft}\setboolean{isdraft}{true}
+    \newboolean{isdraft}\setboolean{isdraft}{false}
     \newboolean{uselinenumbers}\setboolean{uselinenumbers}{true}
     \newboolean{usechangesummary}\setboolean{usechangesummary}{false}
 \newcommand{\draftmark}{\ifthenelse{\boolean{isdraft}}{***FINAL REVIEW DRAFT***}{}}
@@ -67,7 +67,7 @@ escapeinside={\%*}{*)}     % if you want to add a comment within your code
 \usepackage{changepage}    % For odd/even page checks
 \usepackage[usenames,dvipsnames]{xcolor}
 \usepackage{lscape}        % For landscape mode (Appendix B)
-\usepackage{tikz}         % graphics (Name Index (Fig 6.1), Appendix B)
+\usepackage{tikz}             % graphics (Name Index (Fig 6.1), Appendix B)
     \usetikzlibrary{arrows}
     \usetikzlibrary{arrows.meta}
     \usetikzlibrary{backgrounds}
index ce1fdb5..2d06749 100644 (file)
@@ -1694,7 +1694,7 @@ a block containing a DWARF expression or a register location description
 The length operand specifies the length in bytes of the block.  
 \bb
 If the block contains a DWARF expression,
-the DWARF expression is evaluated as if it has been evaluated upon entering
+the DWARF expression is evaluated as if it had been evaluated upon entering
 the current subprogram.  The DWARF expression 
 assumes no values are present on the DWARF stack initially and results
 in exactly one value being pushed on the DWARF stack when completed.
index 76b36d1..ecec287 100644 (file)
@@ -68,6 +68,7 @@ more condensed format.
 \subsection{Lookup by Name}
 \addtoindexx{lookup!by name}
 \addtoindexx{accelerated access!by name}
+\addtoindexx{name index}
 For lookup by name, a name index is maintained in a separate
 object file section named \dotdebugnames{}. 
 
@@ -776,7 +777,7 @@ folded according to the simple case folding algorithm defined in the
 "Caseless Matching" subsection of Section 5.18 ("Case Mappings") of
 the \addtoindex{Unicode} Standard, Version 9.0.0. The original symbol 
 name, as it appears in the source code, should be stored in the name 
-table.
+table.\addtoindex{name index!case folding}
 
 \textit{Thus, two symbols that differ only by case will hash to
 the same slot, but the consumer will be able to distinguish the names
@@ -788,8 +789,8 @@ Character Database. That file defines four classes of mappings:
 Common (C), Simple (S), Full (F), and Turkish (T). 
 The hash computation specified here uses the C + S mappings only, 
 which do not affect the total length of the string, with the addition 
-that Turkish dotted 'I' and undotted 'I', both
-upper and lower case, are translated to the Latin lower case 'i'.
+that Turkish upper case dotted '\.{I}' and lower case dotless '\i'
+are folded to the Latin lower case 'i'.
 \eb
 
 Each bucket contains the index of an entry in the hashes array. The
index 4cc52a2..a603b32 100644 (file)
@@ -1213,19 +1213,20 @@ see Appendix \refersec{app:pascalexample} and
 \refersec{app:ccppbitfieldexamples}.}
 
 \bb
-\subsection{Member Variable Entries}
-\label{chap:membervariableentries}
-
-A member variable (\doublequote{static data member} in 
-\addtoindex{C++}) is represented by a
+\subsection{Class Variable Entries}
+\label{chap:classvariableentries}
+\addtoindexx{class variable entry}
+A class variable (\doublequote{static data member} in 
+\addtoindex{C++}) is a variable shared by all instances
+of a class. It is represented by a
 debugging information entry with the tag \DWTAGvariable.
 
-The member variable entry
+The class variable entry
 may contain the same attributes and follows the same rules
 as non-member global variable entries
 (see Section \refersec{chap:dataobjectentries}).
 
-A member variable entry may have a
+A class variable entry may have a
 \hyperlink{chap:DWATaccessibilityattribute}{\DWATaccessibilityNAME}
 \addtoindexx{accessibility attribute}
 attribute. If no accessibility attribute is present, private
@@ -1233,6 +1234,7 @@ access is assumed for an entry of a class and public access
 is assumed for an entry of a structure, union or interface.
 \eb
 
+\needlines{6}
 \subsection{Member Function Entries}
 \label{chap:memberfunctionentries}