First draft of Version 5, incorporating numerous approved changes
[dwarf-doc.git] / dwarf5 / latexdoc / sectionversionnumbers.tex
index e57ce75..d4496c4 100644 (file)
@@ -21,18 +21,18 @@ numbers are in use for each section.
 
 There are sections with no version number encoded in them;
 they are only accessed via the 
-\addtoindex{.debug\_info} and 
-\addtoindex{.debug\_types}
+\dotdebuginfo{} and 
+\dotdebugtypes{}
 sections and so an incompatible change in those sections'
 format would be represented by a change in the 
-and \addtoindex{.debug\_types} section version number.
+and \dotdebugtypes{} section version number.
 
 \clearpage
 \begin{centering}
 \setlength{\extrarowheight}{0.1cm}
-\begin{longtable}{lccc}
+\begin{longtable}{lcccc}
   \caption{Section version numbers} \label{tab:sectionversionnumbers} \\
-  \hline \\ \bfseries Section Name &\bfseries V2 &\bfseries V3 &\bfseries V4 \\ \hline
+  \hline \bfseries Section Name &\bfseries V2 &\bfseries V3 &\bfseries V4 &\bfseries V5 \\ \hline
 \endfirsthead
    \bfseries Section Name &\bfseries V2 &\bfseries V3 &\bfseries V4 \\ \hline
 \endhead
@@ -40,39 +40,41 @@ and \addtoindex{.debug\_types} section version number.
 \endfoot
   \hline
 \endlastfoot
-\addtoindex{.debug\_abbrev}& -  & -  & -  \\
-\addtoindex{.debug\_aranges}&2&2&2 \\
-\addtoindex{.debug\_frame}&1&3&4 \\
-\addtoindex{.debug\_info}&2&3&4 \\
-\addtoindex{.debug\_line}&2&3&4   \\
-\addtoindex{.debug\_loc}& -  & -  & -  \\
-\addtoindex{.debug\_macinfo}& -  & - & -   \\
-\addtoindex{.debug\_pubnames}&2&2&2    \\
-\addtoindex{.debug\_pubtypes}&x&2&2   \\
-\addtoindex{.debug\_ranges}&x& - & -  \\
-\addtoindex{.debug\_str}& -  & -  & -  \\
-\addtoindex{.debug\_types}&x&x&4   \\
+\dotdebugabbrev{}   & - & - & - & - \\
+\dotdebugaranges{}  & 2 & 2 & 2 & 2 \\
+\dotdebugframe{}    & 1 & 3 & 4 & 4 \\
+\dotdebuginfo{}     & 2 & 3 & 4 & 5 \\
+\dotdebugline{}     & 2 & 3 & 4 & 4 \\
+\dotdebugloc{}      & - & - & - & - \\
+\dotdebugmacinfo{}  & - & - & - & - \\
+\dotdebugpubnames{} & 2 & 2 & 2 & 2 \\
+\dotdebugpubtypes{} & x & 2 & 2 & 2 \\
+\dotdebugranges{}   & x & - & - & - \\
+\dotdebugstr{}      & - & - & - & - \\
+\dotdebugtypes{}    & x & x & 4 & 5 \\
 \end{longtable}
 \end{centering}
 
 Notes:
 
 \begin{itemize}
-\item  ``V2'' means \addtoindex{DWARF Version 2}, published July 1993.
-\item  ``V3'' means \addtoindex{DWARF Version 3}, published December 2005.
-\item  ``V4'' means \addtoindex{DWARF Version 4}, published June 2010.
-\item  ``-'' means that a version number is not applicable
+\item  \doublequote{V2} means \addtoindex{DWARF Version 2}, published July 27, 1993.
+\item  \doublequote{V3} means \addtoindex{DWARF Version 3}, published December 20, 2005.
+\item  \doublequote{V4} means \addtoindex{DWARF Version 4}, published June 10, 2010.
+\item  \doublequote{V5} means \addtoindex{DWARF Version 5}, published 
+                       \ifthenelse{\boolean{isdraft}}{\textit{<to be determined>}}{\docdate}.
+\item  \doublequote{-} means that a version number is not applicable
 (the section's header does not include a version).
 
-\item  ``x'' means that the section was not defined in that
+\item  \doublequote{x} means that the section was not defined in that
 version of the DWARF standard.
 
-\item  The version numbers for the \addtoindex{.debug\_info} and \addtoindex{.debug\_types}
+\item  The version numbers for the \dotdebuginfo{} and \dotdebugtypes{}
 sections must be the same.
 
 \end{itemize}
 
-\textit{For \addtoindex{.debug\_frame}, section version 2 is unused.}
+\textit{For \dotdebugframe{}, section version 2 is unused.}
 
 Higher numbers are reserved for future use.