[gnome-devel-docs] Tutorials: Refining the descriptions

[Susanna Huhtanen <susannah src gnome org>]

commit 6872a27d4ef35c8468e9d22b4f49875311b61309
Author: Susanna Huhtanen <ihmis suski gmail com>
Date:   Mon Feb 20 12:52:55 2012 +0200

    Tutorials: Refining the descriptions

 platform-demos/C/beginner.js.page   |    4 ++--
 platform-demos/C/entry.js.page      |    1 +
 platform-demos/C/helloWorld.js.page |    9 +++++----
 3 files changed, 8 insertions(+), 6 deletions(-)
---
diff --git a/platform-demos/C/beginner.js.page b/platform-demos/C/beginner.js.page
index 50395ea..3e774b7 100644
--- a/platform-demos/C/beginner.js.page
+++ b/platform-demos/C/beginner.js.page
@@ -14,8 +14,8 @@
     <desc>A complete beginner's guide to GTK+ programming</desc>
   </info>
 
-  <title>0 Beginner's Tutorials</title>
-  <p></p>
+  <title>0 Beginner's Tutorials and samples</title>
+  <p>In these tutorials and samples we use JavaScript and GTK+. These tutorials and samples expect you to be familiar with the syntax of JavaScript, if not, read <link href="http://eloquentjavascript.net/contents.html";>Eloquent JavaScript</link> or your preferred guide to JavaScript. </p>
   
   <section id="hello_world">
   <title>Hello World</title>
diff --git a/platform-demos/C/entry.js.page b/platform-demos/C/entry.js.page
index 269fd52..1486b3c 100644
--- a/platform-demos/C/entry.js.page
+++ b/platform-demos/C/entry.js.page
@@ -53,5 +53,6 @@ grid.attach_next_to(entry,label,1,1,1);
 grid.attach_next_to(connectionbutton,label,3,1,1);
 grid.attach_next_to(resultlabel,entry,3,1,1);myW.show_all();
 Gtk.main();]]></code>
+<p>In this sample we use the following widgets: <link href="http://www.roojs.com/seed/gir-1.2-gtk-3.0/gjs/Gtk.Window.html";>Gtk.Window</link>, <link href="http://www.roojs.com/seed/gir-1.2-gtk-3.0/gjs/Gtk.Grid.html";>Gtk.Grid</link>, <link href="">Gtk.Entry</link>, <link href="http://www.roojs.com/seed/gir-1.2-gtk-3.0/gjs/Gtk.Label.html";>Gtk.Label</link>, <link href="http://www.roojs.com/seed/gir-1.2-gtk-3.0/gjs/Gtk.Button.html";>Gtk.Button</link>.</p>
 
 </page>
diff --git a/platform-demos/C/helloWorld.js.page b/platform-demos/C/helloWorld.js.page
index 948578f..2bb4443 100644
--- a/platform-demos/C/helloWorld.js.page
+++ b/platform-demos/C/helloWorld.js.page
@@ -11,17 +11,17 @@
       <years>2012</years>
     </credit>
 
-    <desc></desc>
+    <desc>Tutorial for a hello world application</desc>
   </info>
   <title>Hello World</title>
 
   <synopsis>
-    <p>In this tutorial we'll construct a small program, Hello World, using JavaScript and GTK+. To do and run all the code examples yourself, you need an editor to write code in, terminal and GNOME 3. or higher installed into your computer.</p>
+    <p>In this tutorial we'll construct a small application, Hello World, using JavaScript and GTK+. To do and run all the code examples yourself, you need an editor to write code in, terminal and GNOME 3. or higher installed into your computer.</p>
   </synopsis>
   
   <section id=".js">
-    <title>HelloWorld.js</title>
-    <p>This a basic Hello World done with JavaScript. If you are unfamiliar with JavaScript, read <link href="http://eloquentjavascript.net/contents.html";>Eloquent JavaScript</link> or your preferred guide to JavaScript.  </p>
+    <title>helloWorld.js</title>
+    <p>This a basic Hello World application done with JavaScript and GTK+.</p>
       <code mime="text/javascript" style="numbered"><![CDATA[
 #!/usr/bin/gjs
 //The previous line is a hash bang tells how to run the script.
@@ -43,4 +43,5 @@ mywindow.show();
 //and run it
 Gtk.main();]]></code>
   </section>
+  <p>To run this application open Terminal, go to the folder where your application is stored and then run</p> <screen> <output style="prompt">$ </output><input> GJS_PATH=`pwd` gjs helloWorld.js</input> </screen>
 </page>