[gnome-doc-utils/mallard: 47/87] Adding desc elements to pages

[Shaun McCance <shaunm src gnome org>]

commit 10a74a4ebf0e52f7e24855cb45e56bb96e11cf62
Author: Shaun McCance <shaunm gnome org>
Date:   Fri Nov 14 15:14:34 2008 -0600

    Adding desc elements to pages
---
 doc/mallard/C/mal_attr_link.xml     |    2 ++
 doc/mallard/C/mal_inline_app.xml    |    5 ++---
 doc/mallard/C/mal_inline_cmd.xml    |    2 ++
 doc/mallard/C/mal_inline_code.xml   |    2 ++
 doc/mallard/C/mal_inline_em.xml     |    2 ++
 doc/mallard/C/mal_inline_file.xml   |    2 ++
 doc/mallard/C/mal_inline_gui.xml    |    2 ++
 doc/mallard/C/mal_inline_guiseq.xml |    2 ++
 doc/mallard/C/mal_inline_input.xml  |    2 ++
 doc/mallard/C/mal_inline_key.xml    |    2 ++
 doc/mallard/C/mal_inline_keyseq.xml |    2 ++
 doc/mallard/C/mal_inline_media.xml  |    2 ++
 doc/mallard/C/mal_inline_output.xml |    2 ++
 doc/mallard/C/mal_inline_sys.xml    |    2 ++
 doc/mallard/C/mal_inline_var.xml    |    2 ++
 15 files changed, 30 insertions(+), 3 deletions(-)

diff --git a/doc/mallard/C/mal_attr_link.xml b/doc/mallard/C/mal_attr_link.xml
index 25dc8fe..1e0bfe1 100644
--- a/doc/mallard/C/mal_attr_link.xml
+++ b/doc/mallard/C/mal_attr_link.xml
@@ -15,6 +15,8 @@
   </copyright>
 
   <version number="0.1" date="2008-02-19" status="incomplete"/>
+
+  <desc>Link to other pages or documents directly from most inline elements.</desc>
 </info>
 
 <title>Ubiquitous Linking</title>
diff --git a/doc/mallard/C/mal_inline_app.xml b/doc/mallard/C/mal_inline_app.xml
index 04d6820..c66d3e2 100644
--- a/doc/mallard/C/mal_inline_app.xml
+++ b/doc/mallard/C/mal_inline_app.xml
@@ -8,9 +8,6 @@
 
   <version number="0.1" date="2007-02-08" status="review"/>
 
-  <desc>The <code>app</code> element marks the human-readable name of an
-  application or the title of a window within an application.</desc>
-
   <credit type="author">
     <name>Shaun McCance</name>
     <email>shaunm gnome org</email>
@@ -21,6 +18,8 @@
   </copyright>
 
   <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"; />
+
+  <desc>Mark up the human-readable name of an application or window.</desc>
 </info>
 
 <title>Application Names</title>
diff --git a/doc/mallard/C/mal_inline_cmd.xml b/doc/mallard/C/mal_inline_cmd.xml
index 2b5fd80..b62ce47 100644
--- a/doc/mallard/C/mal_inline_cmd.xml
+++ b/doc/mallard/C/mal_inline_cmd.xml
@@ -19,6 +19,8 @@
   </copyright>
 
   <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"; />
+
+  <desc>Mark up a command to be entered at an interactive shell.</desc>
 </info>
 
 <title>Commands</title>
diff --git a/doc/mallard/C/mal_inline_code.xml b/doc/mallard/C/mal_inline_code.xml
index fa2584b..8a5e53a 100644
--- a/doc/mallard/C/mal_inline_code.xml
+++ b/doc/mallard/C/mal_inline_code.xml
@@ -16,6 +16,8 @@
   </copyright>
 
   <version number="0.1" date="2008-02-19" status="incomplete"/>
+
+  <desc>Mark up code from a programming, markup, or other machine-readable format.</desc>
 </info>
 
 <title>Code Snippets</title>
diff --git a/doc/mallard/C/mal_inline_em.xml b/doc/mallard/C/mal_inline_em.xml
index fef29c2..8737614 100644
--- a/doc/mallard/C/mal_inline_em.xml
+++ b/doc/mallard/C/mal_inline_em.xml
@@ -16,6 +16,8 @@
   </copyright>
 
   <version number="0.1" date="2008-02-19" status="incomplete"/>
+
+  <desc>Emphasize important text.</desc>
 </info>
 
 <title>Emphasis</title>
diff --git a/doc/mallard/C/mal_inline_file.xml b/doc/mallard/C/mal_inline_file.xml
index 2041b54..dbe40e2 100644
--- a/doc/mallard/C/mal_inline_file.xml
+++ b/doc/mallard/C/mal_inline_file.xml
@@ -16,6 +16,8 @@
   </copyright>
 
   <version number="0.1" date="2008-02-19" status="incomplete"/>
+
+  <desc>Mark up the name of a file or directory.</desc>
 </info>
 
 <title>Filenames</title>
diff --git a/doc/mallard/C/mal_inline_gui.xml b/doc/mallard/C/mal_inline_gui.xml
index f936f61..ae7bc95 100644
--- a/doc/mallard/C/mal_inline_gui.xml
+++ b/doc/mallard/C/mal_inline_gui.xml
@@ -16,6 +16,8 @@
   </copyright>
 
   <version number="0.1" date="2008-02-19" status="incomplete"/>
+
+  <desc>Mark up control labels from a graphical user interface.</desc>
 </info>
 
 <title>GUI Labels</title>
diff --git a/doc/mallard/C/mal_inline_guiseq.xml b/doc/mallard/C/mal_inline_guiseq.xml
index d91a479..a46ce19 100644
--- a/doc/mallard/C/mal_inline_guiseq.xml
+++ b/doc/mallard/C/mal_inline_guiseq.xml
@@ -15,6 +15,8 @@
   </copyright>
 
   <version number="0.1" date="2008-02-19" status="incomplete"/>
+
+  <desc>Mark up a sequence of interface controls to navigate.</desc>
 </info>
 
 <title>GUI Sequences</title>
diff --git a/doc/mallard/C/mal_inline_input.xml b/doc/mallard/C/mal_inline_input.xml
index 62247f7..8fdf9b1 100644
--- a/doc/mallard/C/mal_inline_input.xml
+++ b/doc/mallard/C/mal_inline_input.xml
@@ -17,6 +17,8 @@
   </copyright>
 
   <version number="0.1" date="2008-02-19" status="stub"/>
+
+  <desc>Mark up text the user should input into a computer program.</desc>
 </info>
 
 <title>User Input</title>
diff --git a/doc/mallard/C/mal_inline_key.xml b/doc/mallard/C/mal_inline_key.xml
index 964d6bf..9df01b2 100644
--- a/doc/mallard/C/mal_inline_key.xml
+++ b/doc/mallard/C/mal_inline_key.xml
@@ -7,6 +7,8 @@
   <link type="seealso" xref="mal_attr_link"/>
 
   <version number="0.1" date="2007-02-21" status="stub"/>
+
+  <desc>Mark up a key to be pressed on the user's keyboard.</desc>
 </info>
 
 <title>Key Strokes</title>
diff --git a/doc/mallard/C/mal_inline_keyseq.xml b/doc/mallard/C/mal_inline_keyseq.xml
index f83d195..941c554 100644
--- a/doc/mallard/C/mal_inline_keyseq.xml
+++ b/doc/mallard/C/mal_inline_keyseq.xml
@@ -15,6 +15,8 @@
   </copyright>
 
   <version number="0.1" date="2008-02-19" status="incomplete"/>
+
+  <desc>Mark up a key combination or sequence.</desc>
 </info>
 
 <title>Key Sequences</title>
diff --git a/doc/mallard/C/mal_inline_media.xml b/doc/mallard/C/mal_inline_media.xml
index 2397e05..baa1039 100644
--- a/doc/mallard/C/mal_inline_media.xml
+++ b/doc/mallard/C/mal_inline_media.xml
@@ -6,6 +6,8 @@
   <link type="guide" xref="mal_inline#elements"/>
 
   <version number="0.1" date="2007-02-21" status="stub"/>
+
+  <desc>Insert images, video, and sound into your document.</desc>
 </info>
 
 <title>Multimedia Objects</title>
diff --git a/doc/mallard/C/mal_inline_output.xml b/doc/mallard/C/mal_inline_output.xml
index d7201ad..0c00622 100644
--- a/doc/mallard/C/mal_inline_output.xml
+++ b/doc/mallard/C/mal_inline_output.xml
@@ -16,6 +16,8 @@
   </copyright>
 
   <version number="0.1" date="2008-02-19" status="stub"/>
+
+  <desc>Mark up the output from a computer program.</desc>
 </info>
 
 <title>Computer Output</title>
diff --git a/doc/mallard/C/mal_inline_sys.xml b/doc/mallard/C/mal_inline_sys.xml
index 391b1c0..53d7b68 100644
--- a/doc/mallard/C/mal_inline_sys.xml
+++ b/doc/mallard/C/mal_inline_sys.xml
@@ -7,6 +7,8 @@
   <link type="seealso" xref="mal_attr_link"/>
 
   <version number="0.1" date="2007-02-21" status="stub"/>
+
+  <desc>Mark up general identifiers found on computer system.</desc>
 </info>
 
 <title>System Items</title>
diff --git a/doc/mallard/C/mal_inline_var.xml b/doc/mallard/C/mal_inline_var.xml
index 9c597fa..6ac8789 100644
--- a/doc/mallard/C/mal_inline_var.xml
+++ b/doc/mallard/C/mal_inline_var.xml
@@ -7,6 +7,8 @@
   <link type="seealso" xref="mal_attr_link"/>
 
   <version number="0.1" date="2007-02-21" status="stub"/>
+
+  <desc>Mark up placeholder text that should be replaced by the user.</desc>
 </info>
 
 <title>Variable Text</title>