summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRon Brender <ron.brender@gmail.com>2017-02-13 06:33:29 -0500
committerRon Brender <ron.brender@gmail.com>2017-02-13 06:33:29 -0500
commit28a7b6413ad5054f7d05b741734b727ef16988ae (patch)
treed0e7e9dc1b8e1b064583ffa16d5a98864aec4e75
parentFinal Review Draft... (diff)
downloaddwarf-doc-28a7b6413ad5054f7d05b741734b727ef16988ae.tar.gz
dwarf-doc-28a7b6413ad5054f7d05b741734b727ef16988ae.tar.bz2
dwarf-doc-28a7b6413ad5054f7d05b741734b727ef16988ae.tar.xz
Final version...
Signed-off-by: Ron Brender <ron.brender@gmail.com>
-rw-r--r--dwarf5/latexdoc/changesummary.tex1
-rw-r--r--dwarf5/latexdoc/datarepresentation.tex16
-rw-r--r--dwarf5/latexdoc/dwarf5.tex6
-rw-r--r--dwarf5/latexdoc/generaldescription.tex2
-rw-r--r--dwarf5/latexdoc/otherdebugginginformation.tex7
-rw-r--r--dwarf5/latexdoc/typeentries.tex16
6 files changed, 28 insertions, 20 deletions
diff --git a/dwarf5/latexdoc/changesummary.tex b/dwarf5/latexdoc/changesummary.tex
index bcc3d62..647beed 100644
--- a/dwarf5/latexdoc/changesummary.tex
+++ b/dwarf5/latexdoc/changesummary.tex
@@ -15,6 +15,7 @@ This change summary is included only in draft versions of this document.
15\begin{longtable}{ll} 15\begin{longtable}{ll}
16\textbf{Date} & \textbf{Issue Incorporated or Other Change} \\ \hline \\ 16\textbf{Date} & \textbf{Issue Incorporated or Other Change} \\ \hline \\
17\endhead 17\endhead
182/12/2017 & Final tweaks \\
182/3/2017 & 161027.1 (Case sensitive names), 161206.[123] (piece and bit piece), \\ 192/3/2017 & 161027.1 (Case sensitive names), 161206.[123] (piece and bit piece), \\
19 & Final review draft \\ 20 & Final review draft \\
201/24/2017 % Changes from meeting of 1/24/2017 \\ 211/24/2017 % Changes from meeting of 1/24/2017 \\
diff --git a/dwarf5/latexdoc/datarepresentation.tex b/dwarf5/latexdoc/datarepresentation.tex
index a37a63a..0e832f9 100644
--- a/dwarf5/latexdoc/datarepresentation.tex
+++ b/dwarf5/latexdoc/datarepresentation.tex
@@ -711,10 +711,14 @@ to import entries from the \addtoindex{supplementary object file}, other
711\bb 711\bb
712\DWFORMrefsupfour{} or \DWFORMrefsupeight{} 712\DWFORMrefsupfour{} or \DWFORMrefsupeight{}
713\eb 713\eb
714attributes to refer to them and \DWFORMstrpsup{} form attributes to 714attributes to refer
715\bb
716directly to individual entries in the supplementary file,
717\eb
718and \DWFORMstrpsup{} form attributes to
715refer to strings that are used by debug information of multiple 719refer to strings that are used by debug information of multiple
716executables or shared object files. Within the \addtoindex{supplementary object file}'s 720executables or shared object files. Within the \addtoindex{supplementary object file}'s
717debugging sections, form 721debugging sections, forms
718\bb 722\bb
719\DWFORMrefsupfour{}, \DWFORMrefsupeight{} 723\DWFORMrefsupfour{}, \DWFORMrefsupeight{}
720\eb 724\eb
@@ -1862,7 +1866,7 @@ index into an array of addresses in the \dotdebugaddr{} section.
1862The representation of a \DWFORMaddrxoneNAME, \DWFORMaddrxtwoNAME, 1866The representation of a \DWFORMaddrxoneNAME, \DWFORMaddrxtwoNAME,
1863\DWFORMaddrxthreeNAME{} or \DWFORMaddrxfourNAME{} value is a 1867\DWFORMaddrxthreeNAME{} or \DWFORMaddrxfourNAME{} value is a
18641-, 2-, 3- or 4-byte unsigned integer value, respectively, 18681-, 2-, 3- or 4-byte unsigned integer value, respectively,
1865which is similarly interpretated. 1869which is similarly interpreted.
1866\eb 1870\eb
1867The index is relative to the value of the \DWATaddrbase{} attribute 1871The index is relative to the value of the \DWATaddrbase{} attribute
1868of the associated compilation unit. 1872of the associated compilation unit.
@@ -2239,7 +2243,7 @@ index into an array of offsets in the \dotdebugstroffsets{} section.
2239The representation of a \DWFORMstrxoneNAME, \DWFORMstrxtwoNAME, 2243The representation of a \DWFORMstrxoneNAME, \DWFORMstrxtwoNAME,
2240\DWFORMstrxthreeNAME{} or \DWFORMstrxfourNAME{} value is a 2244\DWFORMstrxthreeNAME{} or \DWFORMstrxfourNAME{} value is a
22411-, 2-, 3- or 4-byte unsigned integer value, respectively, 22451-, 2-, 3- or 4-byte unsigned integer value, respectively,
2242which is similarly interpretated. 2246which is similarly interpreted.
2243\eb 2247\eb
2244The offset entries in the \dotdebugstroffsets{} section have the 2248The offset entries in the \dotdebugstroffsets{} section have the
2245same representation as \DWFORMstrp{} values. 2249same representation as \DWFORMstrp{} values.
@@ -3649,7 +3653,7 @@ If the \HFNoffsetentrycount{} is zero, then \DWFORMrnglistx{} cannot
3649be used to access a range list; \DWFORMsecoffset{} must be used 3653be used to access a range list; \DWFORMsecoffset{} must be used
3650instead. If the \HFNoffsetentrycount{} is non-zero, then \DWFORMrnglistx{} 3654instead. If the \HFNoffsetentrycount{} is non-zero, then \DWFORMrnglistx{}
3651may be used to access a range list; this is necessary in split units and 3655may be used to access a range list; this is necessary in split units and
3652otherwise may be more compact than using \DWFORMsecoffset. 3656may be more compact than using \DWFORMsecoffset in non-split units.
3653\eb 3657\eb
3654} 3658}
3655 3659
@@ -3738,7 +3742,7 @@ If the \HFNoffsetentrycount{} is zero, then \DWFORMloclistx{} cannot
3738be used to access a location list; \DWFORMsecoffset{} must be used 3742be used to access a location list; \DWFORMsecoffset{} must be used
3739instead. If the \HFNoffsetentrycount{} is non-zero, then \DWFORMloclistx{} 3743instead. If the \HFNoffsetentrycount{} is non-zero, then \DWFORMloclistx{}
3740may be used to access a location list; this is necessary in split units and 3744may be used to access a location list; this is necessary in split units and
3741otherwise may be more compact than using \DWFORMsecoffset. 3745may be more compact than using \DWFORMsecoffset in non-split units.
3742\eb 3746\eb
3743} 3747}
3744 3748
diff --git a/dwarf5/latexdoc/dwarf5.tex b/dwarf5/latexdoc/dwarf5.tex
index 4d76df5..6dba688 100644
--- a/dwarf5/latexdoc/dwarf5.tex
+++ b/dwarf5/latexdoc/dwarf5.tex
@@ -3,11 +3,11 @@
3% If draft is in the document class list, pix are just suggested 3% If draft is in the document class list, pix are just suggested
4% by an outline, the pic does not appear as a picture. 4% by an outline, the pic does not appear as a picture.
5% 5%
6\newcommand{\docdate}{February 3, 2017} 6\newcommand{\docdate}{February 13, 2017}
7% 7%
8\usepackage{ifthen} 8\usepackage{ifthen}
9 \newcommand{\ifthen}[2]{\ifthenelse{#1}{#2}{}} 9 \newcommand{\ifthen}[2]{\ifthenelse{#1}{#2}{}}
10 \newboolean{isdraft}\setboolean{isdraft}{true} 10 \newboolean{isdraft}\setboolean{isdraft}{false}
11 \newboolean{uselinenumbers}\setboolean{uselinenumbers}{true} 11 \newboolean{uselinenumbers}\setboolean{uselinenumbers}{true}
12 \newboolean{usechangesummary}\setboolean{usechangesummary}{false} 12 \newboolean{usechangesummary}\setboolean{usechangesummary}{false}
13\newcommand{\draftmark}{\ifthenelse{\boolean{isdraft}}{***FINAL REVIEW DRAFT***}{}} 13\newcommand{\draftmark}{\ifthenelse{\boolean{isdraft}}{***FINAL REVIEW DRAFT***}{}}
@@ -67,7 +67,7 @@ escapeinside={\%*}{*)} % if you want to add a comment within your code
67\usepackage{changepage} % For odd/even page checks 67\usepackage{changepage} % For odd/even page checks
68\usepackage[usenames,dvipsnames]{xcolor} 68\usepackage[usenames,dvipsnames]{xcolor}
69\usepackage{lscape} % For landscape mode (Appendix B) 69\usepackage{lscape} % For landscape mode (Appendix B)
70\usepackage{tikz} % graphics (Name Index (Fig 6.1), Appendix B) 70\usepackage{tikz} % graphics (Name Index (Fig 6.1), Appendix B)
71 \usetikzlibrary{arrows} 71 \usetikzlibrary{arrows}
72 \usetikzlibrary{arrows.meta} 72 \usetikzlibrary{arrows.meta}
73 \usetikzlibrary{backgrounds} 73 \usetikzlibrary{backgrounds}
diff --git a/dwarf5/latexdoc/generaldescription.tex b/dwarf5/latexdoc/generaldescription.tex
index ce1fdb5..2d06749 100644
--- a/dwarf5/latexdoc/generaldescription.tex
+++ b/dwarf5/latexdoc/generaldescription.tex
@@ -1694,7 +1694,7 @@ a block containing a DWARF expression or a register location description
1694The length operand specifies the length in bytes of the block. 1694The length operand specifies the length in bytes of the block.
1695\bb 1695\bb
1696If the block contains a DWARF expression, 1696If the block contains a DWARF expression,
1697the DWARF expression is evaluated as if it has been evaluated upon entering 1697the DWARF expression is evaluated as if it had been evaluated upon entering
1698the current subprogram. The DWARF expression 1698the current subprogram. The DWARF expression
1699assumes no values are present on the DWARF stack initially and results 1699assumes no values are present on the DWARF stack initially and results
1700in exactly one value being pushed on the DWARF stack when completed. 1700in exactly one value being pushed on the DWARF stack when completed.
diff --git a/dwarf5/latexdoc/otherdebugginginformation.tex b/dwarf5/latexdoc/otherdebugginginformation.tex
index 76b36d1..ecec287 100644
--- a/dwarf5/latexdoc/otherdebugginginformation.tex
+++ b/dwarf5/latexdoc/otherdebugginginformation.tex
@@ -68,6 +68,7 @@ more condensed format.
68\subsection{Lookup by Name} 68\subsection{Lookup by Name}
69\addtoindexx{lookup!by name} 69\addtoindexx{lookup!by name}
70\addtoindexx{accelerated access!by name} 70\addtoindexx{accelerated access!by name}
71\addtoindexx{name index}
71For lookup by name, a name index is maintained in a separate 72For lookup by name, a name index is maintained in a separate
72object file section named \dotdebugnames{}. 73object file section named \dotdebugnames{}.
73 74
@@ -776,7 +777,7 @@ folded according to the simple case folding algorithm defined in the
776"Caseless Matching" subsection of Section 5.18 ("Case Mappings") of 777"Caseless Matching" subsection of Section 5.18 ("Case Mappings") of
777the \addtoindex{Unicode} Standard, Version 9.0.0. The original symbol 778the \addtoindex{Unicode} Standard, Version 9.0.0. The original symbol
778name, as it appears in the source code, should be stored in the name 779name, as it appears in the source code, should be stored in the name
779table. 780table.\addtoindex{name index!case folding}
780 781
781\textit{Thus, two symbols that differ only by case will hash to 782\textit{Thus, two symbols that differ only by case will hash to
782the same slot, but the consumer will be able to distinguish the names 783the 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:
788Common (C), Simple (S), Full (F), and Turkish (T). 789Common (C), Simple (S), Full (F), and Turkish (T).
789The hash computation specified here uses the C + S mappings only, 790The hash computation specified here uses the C + S mappings only,
790which do not affect the total length of the string, with the addition 791which do not affect the total length of the string, with the addition
791that Turkish dotted 'I' and undotted 'I', both 792that Turkish upper case dotted '\.{I}' and lower case dotless '\i'
792upper and lower case, are translated to the Latin lower case 'i'. 793are folded to the Latin lower case 'i'.
793\eb 794\eb
794 795
795Each bucket contains the index of an entry in the hashes array. The 796Each bucket contains the index of an entry in the hashes array. The
diff --git a/dwarf5/latexdoc/typeentries.tex b/dwarf5/latexdoc/typeentries.tex
index 4cc52a2..a603b32 100644
--- a/dwarf5/latexdoc/typeentries.tex
+++ b/dwarf5/latexdoc/typeentries.tex
@@ -1213,19 +1213,20 @@ see Appendix \refersec{app:pascalexample} and
1213\refersec{app:ccppbitfieldexamples}.} 1213\refersec{app:ccppbitfieldexamples}.}
1214 1214
1215\bb 1215\bb
1216\subsection{Member Variable Entries} 1216\subsection{Class Variable Entries}
1217\label{chap:membervariableentries} 1217\label{chap:classvariableentries}
1218 1218\addtoindexx{class variable entry}
1219A member variable (\doublequote{static data member} in 1219A class variable (\doublequote{static data member} in
1220\addtoindex{C++}) is represented by a 1220\addtoindex{C++}) is a variable shared by all instances
1221of a class. It is represented by a
1221debugging information entry with the tag \DWTAGvariable. 1222debugging information entry with the tag \DWTAGvariable.
1222 1223
1223The member variable entry 1224The class variable entry
1224may contain the same attributes and follows the same rules 1225may contain the same attributes and follows the same rules
1225as non-member global variable entries 1226as non-member global variable entries
1226(see Section \refersec{chap:dataobjectentries}). 1227(see Section \refersec{chap:dataobjectentries}).
1227 1228
1228A member variable entry may have a 1229A class variable entry may have a
1229\hyperlink{chap:DWATaccessibilityattribute}{\DWATaccessibilityNAME} 1230\hyperlink{chap:DWATaccessibilityattribute}{\DWATaccessibilityNAME}
1230\addtoindexx{accessibility attribute} 1231\addtoindexx{accessibility attribute}
1231attribute. If no accessibility attribute is present, private 1232attribute. If no accessibility attribute is present, private
@@ -1233,6 +1234,7 @@ access is assumed for an entry of a class and public access
1233is assumed for an entry of a structure, union or interface. 1234is assumed for an entry of a structure, union or interface.
1234\eb 1235\eb
1235 1236
1237\needlines{6}
1236\subsection{Member Function Entries} 1238\subsection{Member Function Entries}
1237\label{chap:memberfunctionentries} 1239\label{chap:memberfunctionentries}
1238 1240