[gnome-devel-docs] overview: Edits to existing pages



commit 2f5a4f71dd09c304e35b6d92ea52d2843f27f993
Author: Shaun McCance <shaunm gnome org>
Date:   Tue Apr 5 23:11:07 2011 -0400

    overview: Edits to existing pages

 platform-overview/C/atk.page        |   18 ++++++++----------
 platform-overview/C/cairo.page      |    7 ++++---
 platform-overview/C/eds.page        |   11 +++++------
 platform-overview/C/gdk.page        |   16 ++++------------
 platform-overview/C/gobject.page    |    1 +
 platform-overview/C/pango.page      |   15 ++++-----------
 platform-overview/C/pulseaudio.page |   10 ----------
 7 files changed, 26 insertions(+), 52 deletions(-)
---
diff --git a/platform-overview/C/atk.page b/platform-overview/C/atk.page
index 4f2a099..12933b8 100644
--- a/platform-overview/C/atk.page
+++ b/platform-overview/C/atk.page
@@ -5,6 +5,7 @@
   <link type="guide" xref="index" group="atk"/>
   <desc>Support for screen readers and other accessibility
   tools</desc>
+  <revision pkgversion="3.0" date="2011-04-05" status="candidate"/>
 </info>
 
 <title>ATK</title>
@@ -20,9 +21,9 @@ more people to use your application effectively.</p>
 framework.  This framework defines a set of interfaces to which graphical
 interface components adhere.  This allows, for instance, screen readers
 to read the text of an interface and interact with its controls.  ATK
-support is built into GTK+ and the rest of the GNOME platform using the
-GAIL library, so any application using GTK+ will have reasonable
-accessibility support for free.</p>
+support is built into GTK+ and the rest of the GNOME platform, so any
+application using GTK+ will have reasonable accessibility support for
+free.</p>
 
 <p>Nonetheless, you should be aware of accessibility issues when
 when developing your applications.  Although GTK+ interfaces provide
@@ -41,11 +42,8 @@ tools include a screen reader, a screen magnifier, an on-screen
 keyboard, and <app>Dasher</app>, an innovative
 predictive text entry tool.</p>
 
-<p>For extensive recommendations on accessibility, see <link
-href="http://developer.gnome.org/projects/gap/guide/gad/index.html";>GNOME
-Accessibility for Developers</link>.  See also <link
-href="http://library.gnome.org/devel/atk/stable/";>ATK -
-Accessibility Toolkit</link> and the <link
-href="http://library.gnome.org/devel/gail-libgail-util/stable/";>GAIL
-Reference Manual</link>.</p>
+<list style="compact">
+  <item><p><link href="http://developer.gnome.org/projects/gap/guide/gad/index.html";>GNOME Accessibility for Developers</link></p></item>
+  <item><p><link href="http://library.gnome.org/devel/atk/stable/";>ATK Reference</link></p></item>
+</list>
 </page>
diff --git a/platform-overview/C/cairo.page b/platform-overview/C/cairo.page
index 2798686..5464b96 100644
--- a/platform-overview/C/cairo.page
+++ b/platform-overview/C/cairo.page
@@ -4,6 +4,7 @@
 <info>
   <link type="guide" xref="index" group="cairo"/>
   <desc>Modern 2D vector drawing canvas</desc>
+  <revision pkgversion="3.0" date="2011-04-05" status="candidate"/>
 </info>
 
 <title>Cairo</title>
@@ -32,7 +33,7 @@ inside GTK+ is done using Cairo.  Using Cairo for your custom drawing
 will allow your application to have high-quality, anti-aliased, and
 resolution-independent graphics.</p>
 
-<p>For more information on Cairo, see <link
-href="http://www.cairographics.org/manual/";>Cairo: A Vector Graphics
-Library</link>.</p>
+<list style="compact">
+  <item><p><link href="http://www.cairographics.org/manual/";>Cairo Manual</link></p></item>
+</list>
 </page>
diff --git a/platform-overview/C/eds.page b/platform-overview/C/eds.page
index c3a5038..15c3112 100644
--- a/platform-overview/C/eds.page
+++ b/platform-overview/C/eds.page
@@ -4,6 +4,7 @@
 <info>
   <link type="guide" xref="index" group="apps"/>
   <desc>Integration with the desktop-wide address book and calendar</desc>
+  <revision pkgversion="3.0" date="2011-04-05" status="candidate"/>
 </info>
 
 <title>Evolution Data Server</title>
@@ -28,10 +29,8 @@ shows a simple calendar when clicked.  If the user has any appointments
 scheduled, they are shown alongside the calendar.  This makes it easy to
 see upcoming appointments without opening a full calendar application.</p>
 
-<p>For more information on the address book, see <link
-href="http://gnome.org/projects/evolution/developer-doc/libebook/ch01.html";>
-Evolution API Reference: libebook</link>.  For more information on the
-calendar, see <link
-href="http://gnome.org/projects/evolution/developer-doc/libecal/index.html";>
-Evolution API Reference: libecal</link>.</p>
+<list style="compact">
+  <item><p><link href="http://gnome.org/projects/evolution/developer-doc/libebook/ch01.html";>Evolution API Reference: libebook</link></p></item>
+  <item><p><link href="http://gnome.org/projects/evolution/developer-doc/libecal/index.html";>Evolution API Reference: libecal</link></p></item>
+</list>
 </page>
diff --git a/platform-overview/C/gdk.page b/platform-overview/C/gdk.page
index 34cc5a5..c5ca36c 100644
--- a/platform-overview/C/gdk.page
+++ b/platform-overview/C/gdk.page
@@ -4,6 +4,7 @@
 <info>
   <link type="guide" xref="index" group="gdk"/>
   <desc>Underlying windowing and event handling</desc>
+  <revision pkgversion="3.0" date="2011-04-05" status="candidate"/>
 </info>
 
 <title>GDK</title>
@@ -13,15 +14,6 @@ system for graphics and input devices.  Although you will rarely use
 GDK directly in application code, it contains all the necessary
 functionality to draw objects and text to the screen and to interact
 with the user with various input devices.</p>
-<note><p>GDK runs on a number of different platforms, including the X Window
-System, Microsoft Windows, DirectFB, and Quartz.  On any platform, GDK
-provides the same consistent API, allowing GTK+ and GTK+ applications to
-run unmodified.</p></note>
-
-<p>GDK features a graphics context and drawing primitives that are
-suitable for drawing simple objects and rendering images on the screen.
-Since a more extensive drawing system is provided by Cairo, GDK provides
-hooks to use Cairo contexts within GDK.</p>
 
 <p>GDK enables you to access events from keyboards, mice, and other
 input devices, rather than connect to the high-level signals used in
@@ -45,7 +37,7 @@ The simple drawing routines in GDK should generally not be used.
 Instead, you should use the extensive functionality provide by
 Cairo.</p>
 
-<p>For more information on GDK, see the
-<link href="http://library.gnome.org/devel/gdk/stable/";>GDK Reference
-Manual</link>.</p>
+<list style="compact">
+  <item><p><link href="http://library.gnome.org/devel/gdk/stable/";>GDK Reference Manual</link></p></item>
+</list>
 </page>
diff --git a/platform-overview/C/gobject.page b/platform-overview/C/gobject.page
index 73648cf..7c23972 100644
--- a/platform-overview/C/gobject.page
+++ b/platform-overview/C/gobject.page
@@ -3,6 +3,7 @@
       id="gobject">
 <info>
   <link type="guide" xref="index" group="gobject"/>
+  <desc>Bindable and introspectable C object system</desc>
 </info>
 
 <title>GObject</title>
diff --git a/platform-overview/C/pango.page b/platform-overview/C/pango.page
index 0399992..c3acc5e 100644
--- a/platform-overview/C/pango.page
+++ b/platform-overview/C/pango.page
@@ -4,6 +4,7 @@
 <info>
   <link type="guide" xref="index" group="pango"/>
   <desc>Fully internationalized text layout and rendering</desc>
+  <revision pkgversion="3.0" date="2011-04-05" status="candidate"/>
 </info>
 
 <title>Pango</title>
@@ -27,14 +28,6 @@ native languages.  Pango support for multiple writing systems is
 automatic; application developers do not have to write any special
 code to support other languages.</p>
 
-<figure>
-  <title>Displaying Multiple Languages With Pango</title>
-  <desc>Screenshot of the <app>gedit</app>
-  text editor displaying phrases from multiple languages and writing
-  systems.</desc>
-  <media type="image" mime="image/png" src="figures/pango.png" ></media>
-</figure>
-
 <p>Pango supports the text styling used in typical documents
 and interfaces, including italics, font weights, and underlines.
 Pango uses a simple XML-like vocabulary called PangoMarkup which
@@ -52,7 +45,7 @@ portable code, and most importantly, it will ensure that your
 application can render text correctly in hundreds of different
 languages.</p>
 
-<p>For more information on Pango, see the
-<link href="http://library.gnome.org/devel/pango/stable/";>Pango
-Reference Manual</link>.</p>
+<list style="compact">
+  <item><p><link href="http://library.gnome.org/devel/pango/stable/";>Pango Reference Manual</link></p></item>
+</list>
 </page>



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]