Final cleanups before group review. Only Appendix B Figure is pending...
[dwarf-doc.git] / dwarf5 / latexdoc / datarepresentation.tex
index df34b70..dff36d3 100644 (file)
@@ -54,8 +54,8 @@ other vendors.
 To ensure that extensions added by one vendor may be safely
 ignored by consumers that do not understand those extensions,
 the following rules should be followed:
+\begin{enumerate}[1. ]
 
-\begin{enumerate}[1.]
 \item New attributes should be added in such a way that a
 debugger may recognize the format of a new attribute value
 without knowing the content of that attribute value.
@@ -153,7 +153,8 @@ can coexist and be distinguished within a single linked object.
 The differences between the 32\dash\   and 64\dash bit 
 DWARF formats are
 detailed in the following:
-\begin{enumerate}[1.]
+\begin{enumerate}[1. ]
+
 \item  In the 32\dash bit DWARF format, an 
 \addtoindex{initial length field}
 (see 
@@ -318,8 +319,7 @@ units may share the same table.
 
 \subsubsection{Compilation Unit Header}
 \label{datarep:compilationunitheader}
-
-\begin{enumerate}[1.]
+\begin{enumerate}[1. ]
 
 \item unit\_length (initial length) \\
 \addtoindexx{unit\_length}
@@ -373,8 +373,7 @@ contributing to the description of a type that has been
 placed in its own \addtoindex{type unit}, within the 
 \addtoindex{.debug\_types} section,
 consists of the following information:
-
-\begin{enumerate}[1.]
+\begin{enumerate}[1. ]
 
 \item unit\_length (initial length) \\
 \addtoindexx{unit\_length}
@@ -1946,9 +1945,8 @@ Each set of entries in the table of global names contained
 in the \addtoindex{.debug\_pubnames} and 
 \addtoindex{.debug\_pubtypes} sections begins
 with a header consisting of:
+\begin{enumerate}[1. ]
 
-
-\begin{enumerate}[1.]
 \item unit\_length (initial length) \\
 \addtoindexx{unit\_length}
 A 4\dash byte or 12\dash byte unsigned integer 
@@ -2015,8 +2013,7 @@ offset containing the value 0.
 Each set of entries in the table of address ranges contained
 in the \addtoindex{.debug\_aranges}
 section begins with a header containing:
-
-\begin{enumerate}[1.]
+\begin{enumerate}[1. ]
 % FIXME The unit length text is not fully consistent across
 % these tables.
 
@@ -2401,8 +2398,7 @@ The type signature for a type T0 is formed from the
 of a flattened description of the type. The flattened
 description of the type is a byte sequence derived from the
 DWARF encoding of the type as follows:
-
-\begin{enumerate}[1.]
+\begin{enumerate}[1. ]
 
 \item Start with an empty sequence S and a list V of visited
 types, where V is initialized to a list containing the type
@@ -2599,6 +2595,7 @@ if all of the type entries that it contains or refers to in
 Steps 6 and 7 can themselves each be considered for a separate
 \addtoindex{type unit}.}
 
+\needlines{4}
 Where the DWARF producer may reasonably choose two or more
 different forms for a given attribute, it should choose
 the simplest possible form in computing the signature. (For