From 9df8b77604b7ea7132d32f65f2280720b91249c1 Mon Sep 17 00:00:00 2001
From: Alan Coopersmith <alan.coopersmith@oracle.com>
Date: Thu, 16 Dec 2010 23:54:45 -0800
Subject: specs: Fix section titles/nesting

Signed-off-by: Alan Coopersmith <alan.coopersmith@oracle.com>
---
 specs/multibuf.xml | 77 +++++++++++++++++++++++++++---------------------------
 1 file changed, 38 insertions(+), 39 deletions(-)

(limited to 'specs/multibuf.xml')

diff --git a/specs/multibuf.xml b/specs/multibuf.xml
index 263d580..eb01829 100644
--- a/specs/multibuf.xml
+++ b/specs/multibuf.xml
@@ -70,16 +70,16 @@ in this Software without prior written authorization from the X Consortium.
 </legalnotice>
 </bookinfo>
 
-<chapter>
-<title>TITLE</title>
+<preface><title>Warning</title>
 <warning><para>
 The <emphasis remap='I'>Multi-Buffering</emphasis> extension described here
 was a draft standard of the X Consortium prior to Release 6.1.  It has been
 superseded by the Double Buffer
 Extension (DBE).  DBE is an X Consortium Standard as of Release 6.1.
 </para></warning>
+</preface>
 
-<sect1 id="introduction">
+<chapter id="introduction">
 <title>Introduction</title>
 
 <para>
@@ -120,9 +120,9 @@ The authors of this proposal have tried to unify the above documents
 to yield a proposal that incorporates support for double-buffering,
 multi-buffering, and stereo in a way that is acceptable to all concerned.
 </para>
-</sect1>
+</chapter>
 
-<sect1 id="goals">
+<chapter id="goals">
 <title>Goals</title>
 
 <para>
@@ -176,9 +176,9 @@ existing hardware features.
   </listitem>
 </itemizedlist>
 
-</sect1>
+</chapter>
 
-<sect1 id="image_buffers">
+<chapter id="image_buffers">
 <title>Image Buffers</title>
 
 <para>
@@ -316,9 +316,9 @@ the screen contents are not altered and the contents of any
 undisplayed image buffers are undefined.  If backing store was
 maintained for an image buffer, then no exposure events are generated.
 </para>
-</sect1>
+</chapter>
 
-<sect1 id="new_requests">
+<chapter id="new_requests">
 <title>New Requests</title>
 
 <para>
@@ -671,9 +671,9 @@ display are de-allocated.  If the window is not multi-buffered,
 the request is ignored.
 </para>
 
-</sect1>
+</chapter>
 
-<sect1 id="attributes">
+<chapter id="attributes">
 <title>Attributes</title>
 
 <para>
@@ -860,9 +860,9 @@ increment for incompatible changes, and the minor version would
 increment for small upward compatible changes.  Barring changes, the
 major version will be 1, and the minor version will be 1.
 </para>
-</sect1>
+</chapter>
 
-<sect1 id="events">
+<chapter id="events">
 <title>Events</title>
 
 <para>
@@ -958,9 +958,9 @@ becomes <emphasis remap='I'>updated</emphasis>
 <function>DisplayImageBuffers</function>
 request), an <function>UpdateNotify</function> event is generated.
 </para>
-</sect1>
+</chapter>
 
-<sect1 id="errors">
+<chapter id="errors">
 <title>Errors</title>
 
 <para>
@@ -968,14 +968,14 @@ The following error type has been added to support
 this extension:
 </para>
 
-<sect2 id="buffer_2">
+<sect1 id="buffer_2">
 <title>Buffer</title>
 <para>
 A value for a BUFFER argument does not name a defined BUFFER.
 </para>
-</sect2>
+</sect1>
 
-<sect2 id="double_buffering_normal_windows">
+<sect1 id="double_buffering_normal_windows">
 <title>Double-Buffering Normal Windows</title>
 
 <para>
@@ -1023,9 +1023,9 @@ while animating
 DestroyImageBuffers( W )
 </literallayout>
 
-</sect2>
+</sect1>
 
-<sect2 id="multi_buffering_normal_windows">
+<sect1 id="multi_buffering_normal_windows">
 <title>Multi-Buffering Normal Windows</title>
 
 <para>
@@ -1070,9 +1070,9 @@ while animating
 }
 </literallayout>
 
-</sect2>
+</sect1>
 
-<sect2 id="stereo_windows">
+<sect1 id="stereo_windows">
 <title>Stereo Windows</title>
 <para>
 <emphasis remap='I'>How</emphasis> stereo windows are supported on a server
@@ -1175,9 +1175,9 @@ right eyes for normal windows should be the same
 (ie: have no stereo offset).
 </para>
 
-</sect2>
+</sect1>
 
-<sect2 id="single_buffered_stereo_windows">
+<sect1 id="single_buffered_stereo_windows">
 <title>Single-Buffered Stereo Windows</title>
 
 <para>
@@ -1195,9 +1195,9 @@ MapWindow( W )
 
 &lt;draw picture using L,R&gt;
 </literallayout>
-</sect2>
+</sect1>
 
-<sect2 id="double_buffering_stereo_windows">
+<sect1 id="double_buffering_stereo_windows">
 <title>Double-Buffering Stereo Windows</title>
 
 <para>
@@ -1267,9 +1267,9 @@ while animating
 }
 </literallayout>
 
-</sect2>
+</sect1>
 
-<sect2 id="multi_buffering_stereo_windows">
+<sect1 id="multi_buffering_stereo_windows">
 <title>Multi-Buffering Stereo Windows</title>
 
 <para>
@@ -1310,9 +1310,9 @@ while animating
           DisplayImageBuffers( [L(i)], 100, 0 )
 }
 </literallayout>
-</sect2>
+</sect1>
 
-<sect2 id="protocol_encoding">
+<sect1 id="protocol_encoding">
 <title>Protocol Encoding</title>
 
 <para>
@@ -1356,10 +1356,10 @@ Specifies the code that will be returned when
 The following sections describe the protocol
 encoding for this extension.
 </para>
-</sect2>
 </sect1>
+</chapter>
 
-<sect1 id="type">
+<chapter id="type">
 <title>TYPES</title>
 
 <literallayout class="monospaced">
@@ -1379,9 +1379,9 @@ SETofBUFFER_EVENT
         #x04000000   UpdateNotify
 </literallayout>
 
-</sect1>
+</chapter>
 
-<sect1 id="events_2">
+<chapter id="events_2">
 <title>EVENTS</title>
 
 <literallayout class="monospaced">
@@ -1406,8 +1406,8 @@ SETofBUFFER_EVENT
 24                      unused
 </literallayout>
 
-</sect1>
-<sect1 id="errors_2">
+</chapter>
+<chapter id="errors_2">
 <title>ERRORS</title>
 
 <literallayout class="monospaced">
@@ -1421,9 +1421,9 @@ SETofBUFFER_EVENT
 21                           unused
 </literallayout>
 
-</sect1>
+</chapter>
 
-<sect1 id="requests">
+<chapter id="requests">
 <title>REQUESTS</title>
 
 <literallayout class="monospaced">
@@ -1623,6 +1623,5 @@ VALUEs
 
 </literallayout>
 
-</sect1>
 </chapter>
 </book>
-- 
cgit v1.2.1