[PATCH wayland 3/7] doc: Improve the first chapter text and definitions

Tiago Vignatti tiago.vignatti at intel.com
Tue Nov 13 13:28:44 PST 2012


In the beginning of the chapter, it was defined what is the so called "X"
thing and was removed the "Wayland" and "Weston" definitions cause we're
defining later at 1.2 anyway.

"Introduction", "Motivation" and "Compositing manager as the display server"
names sound better a bit than "Overview", "Replacing X11" and "Make the
compositing manager the display server" respectively. That was changed also.

Signed-off-by: Tiago Vignatti <tiago.vignatti at intel.com>
---
 doc/Wayland/en_US/Overview.xml |   31 +++++++++----------------------
 1 file changed, 9 insertions(+), 22 deletions(-)

diff --git a/doc/Wayland/en_US/Overview.xml b/doc/Wayland/en_US/Overview.xml
index c9990a9..51e451e 100644
--- a/doc/Wayland/en_US/Overview.xml
+++ b/doc/Wayland/en_US/Overview.xml
@@ -3,27 +3,14 @@
 <!ENTITY % BOOK_ENTITIES SYSTEM "Wayland.ent">
 %BOOK_ENTITIES;
 ]>
-<chapter id="chap-Wayland-Overview">
-  <title>Wayland Overview</title>
-  <para>
-    <orderedlist>
-      <listitem>
-	<para>
-	  Wayland is a protocol for a new display server
-	</para>
-      </listitem>
-      <listitem>
-	<para>
-	  Weston is the open source project implementing a wayland-based
-	  copmositor
-	</para>
-      </listitem>
-    </orderedlist>
-  </para>
-  <section id="sect-Wayland-Overview-Replacing-X11">
-    <title>Replacing X11</title>
+<chapter id="chap-Introduction">
+  <title>Introduction</title>
+  <section id="sect-Motivation">
+    <title>Motivation</title>
     <para>
-      In Linux and other Unix-like systems, the X stack has grown to
+      Most of Linux and Unix-based systems rely on the X Window System (or
+      simply <emphasis>X</emphasis>) as the low-level protocol for building
+      bitmap graphics interfaces. On these systems, the X stack has grown to
       encompass functionality arguably belonging in client libraries,
       helper libraries, or the host operating system kernel.  Support for
       things like PCI resource management, display configuration management,
@@ -76,8 +63,8 @@
 
   </section>
 
-  <section id="sect-Wayland-Overview-Make-compositing-manager-display-server">
-    <title>Make the compositing manager the display server</title>
+  <section id="sect-Compositing-manager-display-server">
+    <title>Compositing manager as the display server</title>
     <para>
       Wayland is a new display server and compositing protocol, and Weston
       is the implementation of this protocol which builds on top of all the
-- 
1.7.9.5



More information about the wayland-devel mailing list