[gnome-devel-docs] some formatting cleanup

[Jeremy Bicha <jbicha src gnome org>]

commit 059ae60b32d3c2624d7c46165c2da07ce84030d0
Author: Jeremy Bicha <jbicha ubuntu com>
Date:   Wed Aug 15 18:04:07 2012 -0400

    some formatting cleanup

 platform-demos/C/guitar-tuner.cpp.page |    2 +-
 platform-demos/C/helloWorld.js.page    |   26 +++++++++++++-------------
 platform-demos/C/part-1.vala.page      |    6 +++++-
 3 files changed, 19 insertions(+), 15 deletions(-)
---
diff --git a/platform-demos/C/guitar-tuner.cpp.page b/platform-demos/C/guitar-tuner.cpp.page
index b677e1e..c898db3 100644
--- a/platform-demos/C/guitar-tuner.cpp.page
+++ b/platform-demos/C/guitar-tuner.cpp.page
@@ -123,7 +123,7 @@ six strings) and the orientation to vertical.</p>
   <title>Using GStreamermm</title>
   <p>To use GStreamermm, it has to be initialised. We do that by adding the following line of code next to the
   <code>Gtk::Main kit(argc, argv);</code> line in <file>main.cc</file>:</p>
-  <p><code>	Gst::init (argc, argv);</code></p>
+  <code>	Gst::init (argc, argv);</code>
   <p>While we are on it, also make sure that the <file>gstreamermm.h</file> is included in <file>main.cc</file> properly.</p>
 
   <p>In this simple example we will use a tone generator source called <code>audiotestsrc</code> and send the output to the default system sound device, <code>autoaudiosink</code>. We only need to configure the frequency of the tone generator; this is accessible through the <code>freq</code> property of <code>audiotestsrc</code>.</p>
diff --git a/platform-demos/C/helloWorld.js.page b/platform-demos/C/helloWorld.js.page
index f7d12e6..d77ad0c 100644
--- a/platform-demos/C/helloWorld.js.page
+++ b/platform-demos/C/helloWorld.js.page
@@ -124,7 +124,7 @@ app.application.run(ARGV);]]></code>
 
 
   <section id="desktop.in"><title>The <file>.desktop.in</file> file</title>
-      <p>Running applications from the Terminal is useful at the beginning of the application making process. To have fully working <link href= "http://library.gnome.org/admin/system-admin-guide/stable/mimetypes-9.html.en";>application integration</link> in GNOME 3 requires a desktop launcher. For this you need to create a  <file>.desktop</file> file. The <file>.desktop</file> file describes the application name, the used icon and various integration bits. A deeper insight into the <file>.desktop</file> file can be found <link href= "http://developer.gnome.org/desktop-entry-spec/";>here</link>. The <file>.desktop.in</file> file will create <file>.desktop</file>.</p>
+      <p>Running applications from the Terminal is useful at the beginning of the application making process. To have fully working <link href= "http://library.gnome.org/admin/system-admin-guide/stable/mimetypes-9.html.en";>application integration</link> in GNOME 3 requires a desktop launcher. For this you need to create a  <file>.desktop</file> file. The <file>.desktop</file> file describes the application name, the used icon and various integration bits. A deeper insight into the <file>.desktop</file> file can be found <link href= "http://developer.gnome.org/desktop-entry-spec/";>here</link>. The <file>.desktop.in</file> file will create the <file>.desktop</file>.</p>
 
   <note>
        <p>Before continuing, resave <file>helloWorld.js</file> as <file>helloWorld</file>.  Then run this in the command line:</p>
@@ -135,15 +135,15 @@ app.application.run(ARGV);]]></code>
     <code mime="text/desktop" style="numbered"><xi:include href="samples/helloWorld/helloWorld.desktop.in" parse="text"><xi:fallback/></xi:include></code>
 
     <p>Now let's go through some parts of the <code>.desktop.in</code> file.</p>
-    <list>
-      <item><p>Name: This is the application name.</p></item>
-      <item><p>Comment: A short description of the application.</p></item>
-      <item><p>Exec: Specifies a command to execute when you choose the application from the menu. In this example exec just tells where to find the <code>helloWorld</code> file and the file takes care of the rest.</p></item>
-      <item><p>Terminal: Specifies whether the command in the Exec key runs in a terminal window.</p></item>
-    </list>
-
-    <p>To put your application into the appropriate category, you need to add the necessary categories to the Categories line. More information on the different categories can be found in the <link href = "http://standards.freedesktop.org/menu-spec/latest/apa.html";>menu spec</link>.</p>
-    <p>In this example we use an existing icon. For a custom icon you need to have a .svg file of your icon, stored in to /usr/share/icons/hicolor/scalable/apps. Write the name of your icon file to the .desktop.in file, on line 7. More information on icons in: <link href="http://library.gnome.org/admin/system-admin-guide/stable/themes-11.html.en";> Installing Icons for Themes </link>, <link href="https://live.gnome.org/GnomeGoals/AppIcon";>Installing Icons for Themes</link> and <link href="http://freedesktop.org/wiki/Specifications/icon-theme-spec";>on freedesktop.org: Specifications/icon-theme-spec</link>.</p>
+    <terms>
+      <item><title>Name</title><p>The application name.</p></item>
+      <item><title>Comment</title><p>A short description of the application.</p></item>
+      <item><title>Exec</title><p>Specifies a command to execute when you choose the application from the menu. In this example exec just tells where to find the <file>helloWorld</file> file and the file takes care of the rest.</p></item>
+      <item><title>Terminal</title><p>Specifies whether the command in the Exec key runs in a terminal window.</p></item>
+    </terms>
+
+    <p>To put your application into the appropriate category, you need to add the necessary categories to the Categories line. More information on the different categories can be found in the <link href = "http://standards.freedesktop.org/menu-spec/latest/apa.html";>menu specification</link>.</p>
+    <p>In this example we use an existing icon. For a custom icon you need to have a .svg file of your icon, stored in <file>/usr/share/icons/hicolor/scalable/apps</file>. Write the name of your icon file to the .desktop.in file, on line 7. More information on icons in: <link href="http://library.gnome.org/admin/system-admin-guide/stable/themes-11.html.en";> Installing Icons for Themes </link>, <link href="https://live.gnome.org/GnomeGoals/AppIcon";>Installing Icons for Themes</link> and <link href="http://freedesktop.org/wiki/Specifications/icon-theme-spec";>on freedesktop.org: Specifications/icon-theme-spec</link>.</p>
   </section>
 
   <section id="autotools"><title>The build system</title>
@@ -152,7 +152,7 @@ app.application.run(ARGV);]]></code>
     <links type="section"/>
 
       <section id="autogen"><title>autogen.sh</title>
-        <code mime="text/desktop" style="numbered"><xi:include href="samples/helloWorld/autogen.sh" parse="text"><xi:fallback/></xi:include></code>
+        <code mime="application/x-shellscript" style="numbered"><xi:include href="samples/helloWorld/autogen.sh" parse="text"><xi:fallback/></xi:include></code>
 
       <p>After the <file>autogen.sh</file> file is ready and saved, run:</p>
       <screen><output style="prompt">$ </output><input>chmod +x autogen.sh</input></screen>
@@ -160,12 +160,12 @@ app.application.run(ARGV);]]></code>
 
 
     <section id="makefile"><title>Makefile.am</title>
-      <code mime="text/desktop" style="numbered"><xi:include href="samples/helloWorld/Makefile.am" parse="text"><xi:fallback/></xi:include></code>
+      <code mime="application/x-shellscript" style="numbered"><xi:include href="samples/helloWorld/Makefile.am" parse="text"><xi:fallback/></xi:include></code>
     </section>
 
 
     <section id="configure"><title>configure.ac</title>
-      <code mime="text/ac" style="numbered"><xi:include href="samples/helloWorld/configure.ac" parse="text"><xi:fallback/></xi:include></code>
+      <code mime="application/x-shellscript" style="numbered"><xi:include href="samples/helloWorld/configure.ac" parse="text"><xi:fallback/></xi:include></code>
     </section>
 
 
diff --git a/platform-demos/C/part-1.vala.page b/platform-demos/C/part-1.vala.page
index 071b517..fd2f4f3 100644
--- a/platform-demos/C/part-1.vala.page
+++ b/platform-demos/C/part-1.vala.page
@@ -48,7 +48,10 @@
   </steps>
 
 <p>From the <gui>Project</gui> or <gui>Files</gui> tab, open <file>src/hello_world.vala</file> by double-clicking on it. You should see some code:</p>
-    <code mime="text/x-csharpsrc"><![CDATA[
+
+  <listing>
+    <title>src/hello_world.vala</title>
+    <code mime="text/x-csharp"><![CDATA[
 using GLib;
 using Gtk;
 
@@ -87,6 +90,7 @@ public class Main : Object
 		return 0;
 	}
 }]]></code>
+  </listing>
 
 </section>