[gnome-devel-docs] guitar-tuner-c: Updated docs to reflect the new anjuta dnd features

[Johannes Schmid <jhs src gnome org>]

commit 9ec1387d44149731dc67a3755e2fb3e0cd07e6ad
Author: Johannes Schmid <jhs gnome org>
Date:   Thu Mar 17 16:10:18 2011 -0400

    guitar-tuner-c: Updated docs to reflect the new anjuta dnd features
    
    Also deleted devtools-install section because that should really live in the
    wiki instead

 articles/Makefile.am                           |    2 +-
 articles/devtools-install/C/fedora.page        |   52 ------------------------
 articles/devtools-install/C/index.page         |   14 ------
 articles/devtools-install/C/media/fedora.png   |  Bin 5358 -> 0 bytes
 articles/devtools-install/C/media/opensuse.png |  Bin 6957 -> 0 bytes
 articles/devtools-install/C/media/ubuntu.png   |  Bin 4473 -> 0 bytes
 articles/devtools-install/C/opensuse.page      |   34 ---------------
 articles/devtools-install/C/ubuntu.page        |   34 ---------------
 articles/devtools-install/Makefile.am          |   16 -------
 configure.in                                   |    1 -
 demos/C/guitar-tuner.c.page                    |   17 +++++---
 demos/C/media/guitar-tuner-glade.png           |  Bin 0 -> 86712 bytes
 demos/Makefile.am                              |    2 +
 13 files changed, 14 insertions(+), 158 deletions(-)
---
diff --git a/articles/Makefile.am b/articles/Makefile.am
index 8a42128..150a20f 100644
--- a/articles/Makefile.am
+++ b/articles/Makefile.am
@@ -1 +1 @@
-SUBDIRS = devtools-install
+SUBDIRS = 
diff --git a/configure.in b/configure.in
index a9cca2e..ba9bc74 100644
--- a/configure.in
+++ b/configure.in
@@ -9,7 +9,6 @@ AC_OUTPUT([
 Makefile
 accessibility-devel-guide/Makefile
 articles/Makefile
-articles/devtools-install/Makefile
 demos/Makefile
 gdp-handbook/Makefile
 gdp-style-guide/Makefile
diff --git a/demos/C/guitar-tuner.c.page b/demos/C/guitar-tuner.c.page
index 9cfc8a7..513586d 100644
--- a/demos/C/guitar-tuner.c.page
+++ b/demos/C/guitar-tuner.c.page
@@ -88,9 +88,13 @@
   <p>A description of the user interface (UI) is contained in the GtkBuilder file. To edit the user interface, open <file>src/guitar_tuner.ui</file>. This will switch to the interface designer. The design window is in the center; widgets and widgets properties are on the left, and the palette of available widgets is on the right.
   </p>
   <p>The layout of every UI in GTK+ is organized using boxes and tables. Let's use a vertical <gui>GtkButtonBox</gui> here to assign six <gui>GtkButtons</gui>, one for each of the six guitar strings.</p>
+
+<media type="image" mime="image/png" src="media/guitar-tuner-glade.png"/>
+
   <steps>
    <item>
-   <p>Select a <gui>GtkButtonBox</gui> from the <gui>Palette</gui> on the right and put it into the window. In the <gui>Properties</gui> pane, set the number of elements to 6 (for the six strings).</p>
+   <p>Select a <gui>GtkButtonBox</gui> from the <gui>Container</gui>-section of the <gui>Palette</gui> on the right and put it into the window. In the <gui>Properties</gui> pane, set the number of elements to 6 (for the
+six strings) and the orientation to vertical.</p>
    </item>
    <item>
     <p>Now, choose a <gui>GtkButton</gui> from the palette and put it into the first part of the box.</p>
@@ -105,22 +109,23 @@
     <p>Repeat the above steps for the other buttons, adding the next 5 strings with the names <em>A</em>, <em>D</em>, <em>G</em>, <em>B</em>, and <em>e</em>.</p>
     </item>
     <item>
-    <p>Save the UI design by clicking <guiseq><gui>File</gui><gui>Save</gui></guiseq>) and then close it.</p>
+    <p>Save the UI design by clicking <guiseq><gui>File</gui><gui>Save</gui></guiseq>) and keep it open.</p>
     </item>
   </steps>
 </section>
 
 <section>
-  <title>Write the signal handler</title>
-  <p>In the UI designer, you made it so that all of the buttons will call the same function, <gui>on_button_clicked</gui>, when they are clicked. We need to create that function in the source file.</p>
-  <p>To do this, add the following code somewhere in <file>main.c</file>:</p>
+  <title>Creating the signal handler</title>
+  <p>In the UI designer, you made it so that all of the buttons will call the same function, <gui>on_button_clicked</gui>, when they are clicked. We need to add that function in the source file.</p>
+  <p>To do this, open the <file>main.c</file> while the user interface file is still open. Switch to <gui>Signals</gui> tab that you already used to set the signal name. Now take the row where you set the 
+<gui>clicked</gui> signal and drag it into to the source file at a 
+position that is outside any function. The following code will be added to your source file:</p>
 <code mime="text/x-csrc"><![CDATA[
 void on_button_clicked (GtkWidget* button, gpointer user_data)
 {
 
 }]]></code>
   <p>This signal handler has two arguments: a pointer to the GtkWidget that called the function (in our case, always a GtkButton), and a pointer to some "user data" that you can define, but which we won't be using here. (You can set the user data by calling <code>gtk_builder_connect_signals</code>; it is normally used to pass a pointer to a data structure that you might need to access inside the signal handler.)</p>
-  <p>You can find the prototypes of signal handlers in the Gtk+ documentation.</p>
   <p>For now, we'll leave the signal handler empty while we work on writing the code to produce sounds.</p>
 </section>
 
diff --git a/demos/C/media/guitar-tuner-glade.png b/demos/C/media/guitar-tuner-glade.png
new file mode 100644
index 0000000..53b7ceb
Binary files /dev/null and b/demos/C/media/guitar-tuner-glade.png differ
diff --git a/demos/Makefile.am b/demos/Makefile.am
index fd029b0..6c7cbcb 100644
--- a/demos/Makefile.am
+++ b/demos/Makefile.am
@@ -6,6 +6,8 @@ DOC_LINGUAS =
 
 DOC_FIGURES =					\
 	media/guitar-tuner.png			\
+	media/guitar-tuner-glade.png		\
+	media/guitar-tuner-pipeline.png		\
 	media/image-viewer.png			\
 	media/photo-wall.png			\
 	media/photo-wall-zoomed.png		\