Pre-Public Review Draft.
authorRon Brender <ron.brender@gmail.com>
Tue, 13 Sep 2016 18:40:15 +0000 (14:40 -0400)
committerRon Brender <ron.brender@gmail.com>
Tue, 13 Sep 2016 18:40:15 +0000 (14:40 -0400)
Signed-off-by: Ron Brender <ron.brender@gmail.com>
dwarf5/latexdoc/changesummary.tex
dwarf5/latexdoc/datarepresentation.tex
dwarf5/latexdoc/dwarf5.tex
dwarf5/latexdoc/programscope.tex

index 1fb5fb0..0d97cf2 100644 (file)
@@ -15,7 +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
-0/4/2016        & Further Appendix F cleanups \\
+9/13/2016       & Final edits for committee vote \\
+9/4/2016        & Further Appendix F cleanups \\
 8/31-9/1/2016   & Appendix F editorial additions and corrections \\
 8/8/2016        & Pagination review \\
 8/4-7/2016      & 160123.1 (unify location and range lists), 160714.1 (location and range list sections), \\
index 3d50542..64601f3 100644 (file)
@@ -130,7 +130,7 @@ the use of
 the other values is reserved for possible future extensions.
 
 
-\section{Relocatable, Split, Executable, Shared and Package Object Files} 
+\section{Relocatable, Split, Executable, Shared, Package and Supplementary Object Files} 
 \label{datarep:executableobjectsandsharedobjects}
 
 \subsection{Relocatable Object Files}
@@ -661,18 +661,16 @@ For an example, see Figure \refersec{fig:examplecuindexsection}.
 
 \subsection{DWARF Supplementary Object Files}
 \label{datarep:dwarfsupplemetaryobjectfiles}
-In order to minimize the size of debugging information, 
-it is possible to move duplicate debug information entries, 
-strings and macro entries from several executables or shared 
-object files into a separate 
-\addtoindexi{\textit{supplementary object file}}{supplementary object file} 
-by some post-linking utility; the moved entries and strings can 
-then be referenced
-from the debugging information of each of those executable or 
-shared object files.
-
-This facilitates distribution of separate consolidated debug files in
-a simple manner.
+\bb
+\textit{In contrast to split DWARF object files, which allow the compiler to
+split the debugging information between to files in order to reduce
+link time and executable size, a supplementary object file permits a
+post-link utility to analyze many executable and shared object files,
+and collect any duplicate debugging information into a single file
+that can be referenced by each of the original files. This facility
+can be useful for building integrated operating system packages
+and distributions.}
+\eb
 
 \needlines{4}
 A DWARF \addtoindex{supplementary object file} is itself an object file, 
index c10b935..8631594 100644 (file)
@@ -3,13 +3,13 @@
 % 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}{September 4, 2016}
+\newcommand{\docdate}{September 13, 2016}
 %
 \usepackage{ifthen}
     \newcommand{\ifthen}[2]{\ifthenelse{#1}{#2}{}}
     \newboolean{isdraft}\setboolean{isdraft}{true}
     \newboolean{uselinenos}\setboolean{uselinenos}{true}
-\newcommand{\draftmark}{\ifthenelse{\boolean{isdraft}}{*** DRAFT ***}{}}
+\newcommand{\draftmark}{\ifthenelse{\boolean{isdraft}}{*** Pre-PUBLIC REVIEW DRAFT ***}{}}
 %
 \usepackage[T1]{fontenc}
 \usepackage{palatino}
index 30d35fd..8d7a491 100644 (file)
@@ -463,7 +463,7 @@ interpreted relative to this base.
 A \DWATloclistsbase{}\addtoindexx{location table base attribute} 
 attribute, whose value is of class \CLASSloclistsptr. 
 This attribute points to the base of the compilation 
-units contribution to the \dotdebugloclists{} section. References 
+unit's contribution to the \dotdebugloclists{} section. References 
 to location lists (using \DWFORMloclistx) within the compilation 
 unit are interpreted relative to this base.
 \eb