GNOME.org
 

[gnome-devel-docs] tutorials python: succession of pages revisited and next-previous link added to some pages

commit 86af5bdac9f28ee444db66c518b7e0e6a4829125
Author: Marta Maria Casetti <mmcasetti gmail com>
Date:   Sun Feb 24 21:09:50 2013 +0100

    tutorials python: succession of pages revisited and next-previous link added to some pages

 platform-demos/C/GtkApplicationWindow.py.page |    1 +
 platform-demos/C/aboutdialog.py.page          |    3 ++-
 platform-demos/C/button.py.page               |    5 +++--
 platform-demos/C/checkbutton.py.page          |    3 +--
 platform-demos/C/dialog.py.page               |    1 +
 platform-demos/C/entry.py.page                |    1 +
 platform-demos/C/grid.py.page                 |    1 +
 platform-demos/C/image.py.page                |    1 +
 platform-demos/C/label.py.page                |    5 +++--
 platform-demos/C/linkbutton.py.page           |    1 +
 platform-demos/C/progressbar.py.page          |    1 +
 platform-demos/C/properties.py.page           |    9 +++++----
 platform-demos/C/radiobutton.py.page          |    5 ++---
 platform-demos/C/scale.py.page                |    3 ++-
 platform-demos/C/scrolledwindow.py.page       |    1 +
 platform-demos/C/separator.py.page            |    1 +
 platform-demos/C/signals-callbacks.py.page    |    1 +
 platform-demos/C/spinbutton.py.page           |    3 ++-
 platform-demos/C/spinner.py.page              |    1 +
 platform-demos/C/statusbar.py.page            |    1 +
 platform-demos/C/strings.py.page              |   19 +++----------------
 platform-demos/C/switch.py.page               |    2 +-
 platform-demos/C/textview.py.page             |    3 ++-
 platform-demos/C/togglebutton.py.page         |    2 +-
 platform-demos/C/tutorial.py.page             |   21 ++++++++++++---------
 platform-demos/C/window.py.page               |    1 +
 26 files changed, 52 insertions(+), 44 deletions(-)
---
diff --git a/platform-demos/C/GtkApplicationWindow.py.page b/platform-demos/C/GtkApplicationWindow.py.page
index 9f62100..1dffd9a 100644
--- a/platform-demos/C/GtkApplicationWindow.py.page
+++ b/platform-demos/C/GtkApplicationWindow.py.page
@@ -6,6 +6,7 @@
   <info>
     <title type="text">ApplicationWindow (Python)</title>
     <link type="guide" xref="beginner.py#windows"/>
+    <link type="next" xref="image.py"/>
     <revision version="0.1" date="2012-06-10" status="draft"/>
 
     <credit type="author copyright">
diff --git a/platform-demos/C/aboutdialog.py.page b/platform-demos/C/aboutdialog.py.page
index ad1d48a..bd4e6eb 100644
--- a/platform-demos/C/aboutdialog.py.page
+++ b/platform-demos/C/aboutdialog.py.page
@@ -7,6 +7,7 @@
     <title type="text">AboutDialog (Python)</title>
     <link type="guide" xref="beginner.py#windows"/>
     <link type="seealso" xref="signals-callbacks.py"/>
+    <link type="next" xref="messagedialog.py"/>
     <revision version="0.1" date="2012-06-11" status="draft"/>
 
     <credit type="author copyright">
@@ -33,7 +34,7 @@
 
   <section id="methods">
   <title>Useful methods for an AboutDialog widget</title>
-  <p>For an explanation of signals and callback functions, see <link xref="signals-callbacks.py">this 
page</link>.</p>
+  <p>For an explanation of signals and callback functions, see <link xref="signals-callbacks.py" />.</p>
   </section>
 
   <section id="references">
diff --git a/platform-demos/C/button.py.page b/platform-demos/C/button.py.page
index eec472b..2ad94d3 100644
--- a/platform-demos/C/button.py.page
+++ b/platform-demos/C/button.py.page
@@ -7,6 +7,7 @@
     <title type="text">Button (Python)</title>
     <link type="guide" xref="beginner.py#buttons"/>
     <link type="seealso" xref="signals-callbacks.py"/>
+    <link type="next" xref="linkbutton.py"/>
     <revision version="0.2" date="2012-05-05" status="draft"/>
 
     <credit type="author copyright">
@@ -31,8 +32,7 @@
   </section>
   <section id="methods">
     <title>Useful methods for a Button widget</title>
-    <p>For an explanation of signals and callback functions, see <link xref="signals-callbacks.py">this 
page</link>.</p>
-    <p><code>button = Gtk.Button(label="Click me")</code> could also be used to create a button and set the 
text directly. For a general discussion of this, see <link xref="properties.py">here</link>.</p>
+    <p>For an explanation of signals and callback functions, see <link xref="signals-callbacks.py" />.</p>
     <list>
       <item><p><code>set_relief(Gtk.ReliefStyle.NONE)</code> sets to none the relief style of the edges of 
the Gtk.Button - as opposed to <code>Gtk.ReliefStyle.NORMAL</code>.</p></item>
       <item><p>If the label of the button is a <link 
href="http://developer.gnome.org/gtk3/unstable/gtk3-Stock-Items.html";>stock icon</link>, 
<code>set_use_stock(True)</code> sets the label as the name of the corresponding stock icon.</p></item>
@@ -45,6 +45,7 @@ button.set_image(image)</code>
       <item><p>If we use <code>set_focus_on_click(False)</code> the button will not grab focus when it is 
clicked by the mouse. This could be useful in places like toolbars, so that the keyboard focus is not removed 
from the main area of the application.</p></item>
     </list>
   </section>
+  
   <section id="references">
     <title>API References</title>
     <p>In this sample we used the following:</p>
diff --git a/platform-demos/C/checkbutton.py.page b/platform-demos/C/checkbutton.py.page
index 880b1f8..6ca0368 100644
--- a/platform-demos/C/checkbutton.py.page
+++ b/platform-demos/C/checkbutton.py.page
@@ -7,6 +7,7 @@
     <title type="text">CheckButton (Python)</title>
     <link type="guide" xref="beginner.py#buttons"/>
     <link type="seealso" xref="signals-callbacks.py"/>
+    <link type="next" xref="togglebutton.py"/>
     <revision version="0.1" date="2012-05-09" status="draft"/>
 
     <credit type="author copyright">
@@ -29,8 +30,6 @@
 
     <code mime="text/x-python" style="numbered"><xi:include href="samples/checkbutton.py" 
parse="text"><xi:fallback/></xi:include></code>
 
-    <p>We could also create the CheckButton with <code>button = Gtk.CheckButton.new_with_label("Show 
Title")</code>.</p>
-
   </section>
 
   <section id="methods">
diff --git a/platform-demos/C/dialog.py.page b/platform-demos/C/dialog.py.page
index ec35b0f..5e43bf2 100644
--- a/platform-demos/C/dialog.py.page
+++ b/platform-demos/C/dialog.py.page
@@ -7,6 +7,7 @@
     <title type="text">Dialog (Python)</title>
     <link type="guide" xref="beginner.py#windows"/>
     <link type="seealso" xref="signals-callbacks.py"/>
+    <link type="next" xref="aboutdialog.py" />
     <revision version="0.1" date="2012-06-11" status="draft"/>
 
     <credit type="author copyright">
diff --git a/platform-demos/C/entry.py.page b/platform-demos/C/entry.py.page
index 8397167..9dd6b8f 100644
--- a/platform-demos/C/entry.py.page
+++ b/platform-demos/C/entry.py.page
@@ -6,6 +6,7 @@
   <info>
     <title type="text">Entry (Python)</title>
     <link type="guide" xref="beginner.py#entry"/>
+    <link type="next" xref="scale.py" />
     <revision version="0.2" date="2012-06-23" status="draft"/>
 
     <credit type="author copyright editor">
diff --git a/platform-demos/C/grid.py.page b/platform-demos/C/grid.py.page
index 48fe463..4eca655 100644
--- a/platform-demos/C/grid.py.page
+++ b/platform-demos/C/grid.py.page
@@ -7,6 +7,7 @@
     <title type="text">Grid (Python)</title>
     <link type="guide" xref="beginner.py#layout"/>
     <link type="seealso" xref="label.py"/>
+    <link type="next" xref="separator.py"/>
     <revision version="0.2" date="2012-08-01" status="stub"/>
 
     <credit type="author copyright">
diff --git a/platform-demos/C/image.py.page b/platform-demos/C/image.py.page
index 8affbc2..05dbf09 100644
--- a/platform-demos/C/image.py.page
+++ b/platform-demos/C/image.py.page
@@ -6,6 +6,7 @@
   <info>
     <title type="text">Image (Python)</title>
     <link type="guide" xref="beginner.py#display-widgets"/>
+    <link type="next" xref="strings.py"/>
     <revision version="0.2" date="2012-06-14" status="draft"/>
 
     <credit type="author copyright">
diff --git a/platform-demos/C/label.py.page b/platform-demos/C/label.py.page
index 4fa57ff..c7e8083 100644
--- a/platform-demos/C/label.py.page
+++ b/platform-demos/C/label.py.page
@@ -7,6 +7,7 @@
     <title type="text">Label (Python)</title>
     <link type="guide" xref="beginner.py#display-widgets"/>
     <link type="seealso" xref="strings.py" />
+    <link type="next" xref="grid.py" />
     <revision version="0.2" date="2012-06-18" status="draft"/>
 
     <credit type="author copyright">
@@ -66,8 +67,8 @@ class MyApplication(Gtk.Application):
 
   <section id="methods">
   <title>Useful methods for a Label widget</title>
-  <p>An explanation of how to deal with strings and Unicode (and a recap of what these things are) can be 
found <link xref="strings.py.page">here</link>.</p>
-  <p><code>label = Gtk.Label(label="Hello GNOME!")</code> could also be used to create a label and set the 
text directly. For a general discussion of this, see <link xref="properties.py">here</link>.</p>
+  <p>An explanation of how to deal with strings in GTK+ can be found at <link xref="strings.py.page" />.</p>
+  <p><code>label = Gtk.Label(label="Hello GNOME!")</code> could also be used to create a label and set the 
text directly. For a general discussion of this, see <link xref="properties.py" />.</p>
   <list>
     <item><p><code>set_line_wrap(True)</code> breaks lines if the text of the label exceeds the size of the 
widget.</p></item>
     <item><p><code>set_justify(Gtk.Justification.LEFT)</code> (or <code>Gtk.Justification.RIGHT, 
Gtk.Justification.CENTER, Gtk.Justification.FILL</code>) sets the alignment of the lines in the text of the 
label relative to each other. The method has no effect on a single-line label.</p></item>
diff --git a/platform-demos/C/linkbutton.py.page b/platform-demos/C/linkbutton.py.page
index 003f018..0af095d 100644
--- a/platform-demos/C/linkbutton.py.page
+++ b/platform-demos/C/linkbutton.py.page
@@ -7,6 +7,7 @@
     <title type="text">LinkButton (Python)</title>
     <link type="guide" xref="beginner.py#buttons"/>
     <link type="seealso" xref="signals-callbacks.py"/>
+    <link type="next" xref="checkbutton.py"/>
     <revision version="0.1" date="2012-05-23" status="draft"/>
 
     <credit type="author copyright">
diff --git a/platform-demos/C/progressbar.py.page b/platform-demos/C/progressbar.py.page
index edfff3b..128a051 100644
--- a/platform-demos/C/progressbar.py.page
+++ b/platform-demos/C/progressbar.py.page
@@ -6,6 +6,7 @@
   <info>
     <title type="text">ProgressBar (Python)</title>
     <link type="guide" xref="beginner.py#display-widgets"/>
+    <link type="next" xref="spinbutton.py" />    
     <revision version="0.2" date="2012-06-12" status="draft"/>
 
     <credit type="author copyright">
diff --git a/platform-demos/C/properties.py.page b/platform-demos/C/properties.py.page
index fbe3dd7..01ae2af 100644
--- a/platform-demos/C/properties.py.page
+++ b/platform-demos/C/properties.py.page
@@ -7,6 +7,7 @@
 <info>
   <title type="text">Properties (Python)</title>
   <link type="guide" xref="beginner.py#theory"/>
+  <link type="next" xref="window.py"/>
   <revision version="0.1" date="2012-06-24" status="draft"/>
 
   <desc>An explanation of properties, getters and setters.</desc>
@@ -29,20 +30,20 @@
 <section id="overview">
 <title>Overview</title>
 
-<p><em>Properties</em> describe the configuration and state of widgets, and each widget has its own 
particular set of properties. For example, a widget such as a button or a label has the property "label" 
which contains the text of the widget. You can specify the name and value of any number of properties as 
keyword arguments when creating an instance of a widget: for example, to create a label aligned to the right 
with the text “Hello World” and an angle of 25 degrees, you can use:</p>
+<p><em>Properties</em> describe the configuration and state of widgets, and each widget has its own 
particular set of properties. For example, a widget such as a button or a label has the property "label" 
which contains the text of the widget. You can specify the name and value of any number of properties as 
keyword arguments when creating an instance of a widget: for example, to create a label with the text “Hello 
World”, an angle of 25 degrees, and aligned to the right, you can use:</p>
 <code>
 label = Gtk.Label(label="Hello World", angle=25, halign=Gtk.Align.END)</code>
 
-<p>This is equivalent to:</p>
+<p>which is equivalent to using:</p>
 <code>
 label = Gtk.Label()
 label.set_label("Hello World")
 label.set_angle(25)
 label.set_halign(Gtk.Align.END)</code>
 
-<p>Once you have created such a label, you can get the text with the getter 
<code>label.get_label()</code>.</p>
+<p>Once you have created such a label, you can get the text of the label with the getter 
<code>label.get_label()</code>, and analogously for the other properties.</p>
 
-<p>Instead of using getters and setters you can also get and set the properties with 
<code>get_property("prop-name")</code> and <code>set_property("prop-name", value)</code>, respectively.</p>
+<p>Instead of using getters and setters you can also get and set the properties with 
<code>get_property(<var>"prop-name"</var>)</code> and <code>set_property(<var>"prop-name"</var>, 
<var>value</var>)</code>, respectively.</p>
 
 </section>
 <section id="references">
diff --git a/platform-demos/C/radiobutton.py.page b/platform-demos/C/radiobutton.py.page
index 15a7234..2e46f39 100644
--- a/platform-demos/C/radiobutton.py.page
+++ b/platform-demos/C/radiobutton.py.page
@@ -9,7 +9,7 @@
     <link type="seealso" xref="signals-callbacks.py"/>
     <link type="seealso" xref="togglebutton.py"/>
     <link type="seealso" xref="grid.py"/>
-
+    <link type="next" xref="statusbar.py"/>
     <revision version="0.1" date="2012-05-09" status="draft"/>
 
     <credit type="author copyright">
@@ -36,11 +36,10 @@
     <title>Useful methods for a RadioButton widget</title>
     <p>For an explanation of signals and callback functions, see <link xref="signals-callbacks.py">this 
page</link>.</p>
 
-    <p>Instead of <code>button1 = Gtk.RadioButton(label="Button 1")</code> we could create the button and 
label it with</p>
+    <p>As seen in <link xref="properties.py"/>, instead of <code>button1 = Gtk.RadioButton(label="Button 
1")</code> we could create the button and label it with</p>
     <code>
 button1 = Gtk.RadioButton()
 button1.set_label("Button 1").</code>
-    <p>For a general discussion of this, see <link xref="properties.py">here</link>.</p>
     <p>Yet another way to create a new RadioButton with a label is <code>button1 = 
Gtk.RadioButton.new_with_label(None, "Button 1")</code> (the first arguement is the group of the 
radiobuttons, which we can get with <code>get_group()</code>, the second argument is the label).</p>
   </section>
 
diff --git a/platform-demos/C/scale.py.page b/platform-demos/C/scale.py.page
index a998d6b..abb5d61 100644
--- a/platform-demos/C/scale.py.page
+++ b/platform-demos/C/scale.py.page
@@ -7,6 +7,7 @@
     <title type="text">Scale (Python)</title>
     <link type="guide" xref="beginner.py#entry"/>
     <link type="seealso" xref="grid.py"/>
+    <link type="next" xref="textview.py" />
     <revision version="0.2" date="2012-06-23" status="draft"/>
 
     <credit type="author copyright">
@@ -31,7 +32,7 @@
 
   <section id="methods">
     <title>Useful methods for a Scale widget</title>
-    <p>For an explanation of signals and callback functions, see <link xref="signals-callbacks.py">this 
page</link>. An example is the <code>"value-changed"</code> signal, emitted when the value of the scale 
changes.</p>
+    <p>For an explanation of signals and callback functions, see <link xref="signals-callbacks.py"/>. An 
example is the <code>"value-changed"</code> signal, emitted when the value of the scale changes.</p>
     <p>A Gtk.Adjustment is needed to construct the Gtk.Scale. This is the representation of a value with a 
lower and upper bound, together with step and page increments, and a page size, and it is constructed as 
<code>Gtk.Adjustment(value, lower, upper, step_increment, page_increment, page_size)</code> where the fields 
are of type <code>float</code>; <code>step_increment</code> is the increment/decrement that is obtained by 
using the cursor keys, <code>page_increment</code> the one that is obtained clicking on the scale itself. 
Note that <code>page_size</code> is not used in this case, it should be set to <code>0</code>.</p>
     <list>
       <item><p><code>get_value()</code> retrieves the current value of the scale; 
<code>set_value(value)</code> sets it (if the <code>value</code>, of type <code>float</code>, is outside the 
minimum or maximum range, it will be clamped to fit inside them). These are methods of the class 
Gtk.Range.</p></item>
diff --git a/platform-demos/C/scrolledwindow.py.page b/platform-demos/C/scrolledwindow.py.page
index 46fe59f..af1848c 100644
--- a/platform-demos/C/scrolledwindow.py.page
+++ b/platform-demos/C/scrolledwindow.py.page
@@ -6,6 +6,7 @@
   <info>
     <title type="text">ScrolledWindow (Python)</title>
     <link type="guide" xref="beginner.py#scrolling"/>
+    <link type="next" xref="signals-callbacks.py"/>
     <revision version="0.1" date="2012-05-26" status="draft"/>
 
     <credit type="author copyright">
diff --git a/platform-demos/C/separator.py.page b/platform-demos/C/separator.py.page
index c7b76c9..05f10a1 100644
--- a/platform-demos/C/separator.py.page
+++ b/platform-demos/C/separator.py.page
@@ -7,6 +7,7 @@
     <title type="text">Seperator (Python)</title>
     <link type="guide" xref="beginner.py#ornaments"/>
     <link type="seealso" xref="grid.py"/>
+    <link type="next" xref="scrolledwindow.py" />
     <revision version="0.1" date="2012-06-01" status="draft"/>
 
     <credit type="author copyright">
diff --git a/platform-demos/C/signals-callbacks.py.page b/platform-demos/C/signals-callbacks.py.page
index 3b85c08..8a0a074 100644
--- a/platform-demos/C/signals-callbacks.py.page
+++ b/platform-demos/C/signals-callbacks.py.page
@@ -7,6 +7,7 @@
 <info>
   <title type="text">Signals and callbacks (Python)</title>
   <link type="guide" xref="beginner.py#theory"/>
+  <link type="next" xref="button.py"/>
   <revision version="0.1" date="2012-06-16" status="draft"/>
 
   <desc>An explanation of signals and callbacks in GTK+.</desc>
diff --git a/platform-demos/C/spinbutton.py.page b/platform-demos/C/spinbutton.py.page
index 194be88..f886bce 100644
--- a/platform-demos/C/spinbutton.py.page
+++ b/platform-demos/C/spinbutton.py.page
@@ -7,6 +7,7 @@
     <title type="text">SpinButton (Python)</title>
     <link type="guide" xref="beginner.py#entry"/>
     <link type="seealso" xref="grid.py"/>
+    <link type="next" xref="entry.py" />    
     <revision version="0.2" date="2012-06-23" status="draft"/>
 
     <credit type="author copyright">
@@ -31,7 +32,7 @@
 
   <section id="methods">
     <title>Useful methods for a SpinButton widget</title>
-    <p>For an explanation of signals and callback functions, see <link xref="signals-callbacks.py">this 
page</link>. An example is the <code>"value-changed"</code> signal, emitted when the value of the spinbutton 
changes.</p>
+    <p>For an explanation of signals and callback functions, see <link xref="signals-callbacks.py" />. An 
example is the <code>"value-changed"</code> signal, emitted when the value of the spinbutton changes.</p>
     <p>A Gtk.Adjustment is needed to construct the Gtk.SpinButton. This is the representation of a value 
with a lower and upper bound, together with step and page increments, and a page size, and it is constructed 
as <code>Gtk.Adjustment(value, lower, upper, step_increment, page_increment, page_size)</code> where the 
fields are of type <code>float</code>; <code>step_increment</code> is the increment/decrement that is 
obtained by using the cursor keys or the buttons of the spinbutton. Note that <code>page_increment</code> and 
<code>page_size</code> are not used in this case, and they should be set to <code>0</code>.</p>
     <list>
       <item><p>If you want the value of the spinbutton to wrap around when they exceed the maximum or the 
minimum, set <code>set_wrap(True)</code>. The <code>"wrapped"</code> signal is emitted when this 
happens.</p></item>
diff --git a/platform-demos/C/spinner.py.page b/platform-demos/C/spinner.py.page
index df4e9b6..36bddfb 100644
--- a/platform-demos/C/spinner.py.page
+++ b/platform-demos/C/spinner.py.page
@@ -6,6 +6,7 @@
   <info>
     <title type="text">Spinner (Python)</title>
     <link type="guide" xref="beginner.py#display-widgets"/>
+    <link type="next" xref="progressbar.py" />    
     <revision version="0.2" date="2012-06-12" status="draft"/>
 
     <credit type="author copyright">
diff --git a/platform-demos/C/statusbar.py.page b/platform-demos/C/statusbar.py.page
index 693ac16..9155327 100644
--- a/platform-demos/C/statusbar.py.page
+++ b/platform-demos/C/statusbar.py.page
@@ -9,6 +9,7 @@
     <link type="seealso" xref="grid.py"/>
     <link type="seealso" xref="button.py"/>
     <link type="seealso" xref="label.py"/>
+    <link type="next" xref="spinner.py" />    
     <revision version="0.2" date="2012-06-12" status="draft"/>
 
     <credit type="author copyright">
diff --git a/platform-demos/C/strings.py.page b/platform-demos/C/strings.py.page
index 8eabc98..43293ac 100644
--- a/platform-demos/C/strings.py.page
+++ b/platform-demos/C/strings.py.page
@@ -7,6 +7,7 @@
 <info>
   <title type="text">Strings (Python)</title>
   <link type="guide" xref="beginner.py#theory"/>
+  <link type="next" xref="label.py"/>
   <revision version="0.1" date="2012-06-16" status="draft"/>
 
   <desc>An explanation of how to deal with strings in Python and GTK+.</desc>
@@ -26,21 +27,7 @@
 
 <links type="section" />
 
-<section id="definitions">
-<title>Definitions</title>
-
-<p>Conceptionally, a <em>string</em> is a list of <em>characters</em> such as 'A', 'B', 'C' or '&#200;'. 
Characters are abstract representations and their meaning depends on the language and context they are used 
in. The <em>Unicode standard</em> describes how characters are represented by <em>code points</em>. For 
example the characters above are represented with the code points U+0041, U+0042, U+0043, and U+00C9, 
respectively. Basically, code points are numbers in the range from 0 to 0x10FFFF.</p>
-
-<p>The representation of a string as a list of code points is abstract. In order to convert this abstract 
representation into a sequence of bytes the Unicode string must be <em>encoded</em>. The simplest from of 
encoding is ASCII and is performed as follows:</p>
-
-<list>
-  <item><p>If the code point is strictly less than 128, each byte is the same as the value of the code 
point.</p></item>
-  <item><p>If the code point is 128 or greater, the Unicode string can’t be represented in this encoding. 
(Python raises a <sys>UnicodeEncodeError</sys> exception in this case.)</p></item>
-</list>
-
-<p>Although ASCII encoding is simple to apply it can only encode for 128 different characters which is 
hardly enough. One of the most commonly used encodings that addresses this problem is UTF-8 (it can handle 
any Unicode code point). UTF stands for “Unicode Transformation Format”, and the ‘8’ means that 8-bit numbers 
are used in the encoding.</p>
-
-</section>
+<note style="warning"><p>GNOME strongly encourages the use of Python 3 for writing applications!</p></note>
 
 <section id="python-2">
 <title>Strings in Python 2</title>
@@ -116,7 +103,7 @@ b'Fu\xc3\x9fb\xc3\xa4lle sind rund']]></code>
 
 <p>In general it is recommended to not use <code>unicode</code> objects in GTK+ applications at all, and 
only use UTF-8 encoded <code>str</code> objects since GTK+ does not fully integrate with <code>unicode</code> 
objects.</p>
 
-<p>With Python 3.x things are much more consistent, because PyGObject will automatically encode/decode 
to/from UTF-8 if you pass a string to a method or a method returns a string. Strings, or text, will always be 
represented as instances of <code>str</code> only:</p>
+<p>With Python 3.x things are much more consistent, because PyGObject will automatically encode/decode 
to/from UTF-8 if you pass a string to a method or a method returns a string. Strings, or text, will always be 
represented as instances of <code>str</code> only.</p>
 
 </section>
 
diff --git a/platform-demos/C/switch.py.page b/platform-demos/C/switch.py.page
index f85afc2..b481a22 100644
--- a/platform-demos/C/switch.py.page
+++ b/platform-demos/C/switch.py.page
@@ -10,7 +10,7 @@
     <link type="seealso" xref="checkbutton.py"/>
     <link type="seealso" xref="label.py"/>
     <link type="seealso" xref="grid.py"/>
-
+    <link type="next" xref="radiobutton.py"/>
     <revision version="0.1" date="2012-05-24" status="draft"/>
 
     <credit type="author copyright">
diff --git a/platform-demos/C/textview.py.page b/platform-demos/C/textview.py.page
index 82950d2..76a270a 100644
--- a/platform-demos/C/textview.py.page
+++ b/platform-demos/C/textview.py.page
@@ -8,6 +8,7 @@
     <link type="guide" xref="beginner.py#multiline"/>
     <link type="seealso" xref="strings.py" />
     <link type="seealso" xref="scrolledwindow.py"/>
+    <link type="next" xref="dialog.py" />
     <revision version="0.2" date="2012-06-19" status="draft"/>
 
     <credit type="author copyright">
@@ -46,7 +47,7 @@
 
   <section id="methods">
   <title>Useful methods for a TextView widget</title>
-  <p>An explanation of how to deal with strings and Unicode (and a recap of what these things are) can be 
found <link xref="strings.py.page">here</link>.</p>
+  <p>Go to <link xref="strings.py.page" /> for an explanation of how to deal with strings and Unicode.</p>
   <p>A <code>Gtk.TextView</code> displays the text stored in a <code>Gtk.TextBuffer</code>. However, most 
text manipulation is accomplished with iterators, represented by a <code>Gtk.TextIter</code> - a position 
between two characters in the text buffer. Iterators are not valid indefinitely; whenever the buffer is 
modified in a way that affects the contents of the buffer, all outstanding iterators become invalid. Because 
of this, iterators can’t be used to preserve positions across buffer modifications. To preserve a position, 
we use a <code>Gtk.TextMark</code>, that can be set visible with <code>visible(True)</code>. A text buffer 
contains two built-in marks; an "insert" mark (the position of the cursor) and the "selection_bound" mark.</p>
   <p>Methods for a TextView widget:</p>
   <list>
diff --git a/platform-demos/C/togglebutton.py.page b/platform-demos/C/togglebutton.py.page
index 24b6dde..630f80d 100644
--- a/platform-demos/C/togglebutton.py.page
+++ b/platform-demos/C/togglebutton.py.page
@@ -8,7 +8,7 @@
     <link type="guide" xref="beginner.py#buttons"/>
     <link type="seealso" xref="signals-callbacks.py"/>
     <link type="seealso" xref="grid.py"/>
-
+    <link type="next" xref="switch.py"/>
     <revision version="0.1" date="2012-05-23" status="draft"/>
 
     <credit type="author copyright">
diff --git a/platform-demos/C/tutorial.py.page b/platform-demos/C/tutorial.py.page
index 2886942..8fd3735 100644
--- a/platform-demos/C/tutorial.py.page
+++ b/platform-demos/C/tutorial.py.page
@@ -49,6 +49,10 @@
 <steps>
   <title>Tutorial</title>
   <item><steps>
+    <title>Introduction to properties</title>
+    <item><p><link xref="properties.py" /></p></item>
+  </steps></item>
+  <item><steps>
     <title>Basic windows</title>
     <item><p><link xref="window.py" /></p></item>
     <item><p><link xref="GtkApplicationWindow.py" /></p></item>
@@ -58,18 +62,15 @@
     <item><p><link xref="image.py" /></p></item>
     <item><p><link xref="strings.py" /></p></item>
     <item><p><link xref="label.py" /></p></item>
-    <item><p><link xref="properties.py" /></p></item>
   </steps></item>
   <item><steps>
-    <title>Grid</title>
+    <title>Grid, separator and scrolling</title>
     <item><p><link xref="grid.py" /></p></item>
-  </steps></item>
-  <item><steps>
-    <title>Ornaments</title>
     <item><p><link xref="separator.py" /></p></item>
+    <item><p><link xref="scrolledwindow.py" /></p></item>
   </steps></item>
   <item><steps>
-    <title>Basic buttons</title>
+    <title>Signals, callbacks and buttons</title>
     <item><p><link xref="signals-callbacks.py" /></p></item>
     <item><p><link xref="button.py" /></p></item>
     <item><p><link xref="linkbutton.py" /></p></item>
@@ -85,14 +86,16 @@
     <item><p><link xref="progressbar.py" /></p></item>
   </steps></item>
   <item><steps>
-    <title>Entry widgets (with a detour on basic scrolling)</title>
+    <title>Entry widgets</title>
     <item><p><link xref="spinbutton.py" /></p></item>
     <item><p><link xref="entry.py" /></p></item>
-    <item><p><link xref="scrolledwindow.py" /></p></item>
-    <item><p><link xref="textview.py" /></p></item>
     <item><p><link xref="scale.py" /></p></item>
   </steps></item>
   <item><steps>
+    <title>A widget to write and display text</title>
+    <item><p><link xref="textview.py" /></p></item>
+  </steps></item>
+  <item><steps>
     <title>Dialogs</title>
     <item><p><link xref="dialog.py" /></p></item>
     <item><p><link xref="aboutdialog.py" /></p></item>
diff --git a/platform-demos/C/window.py.page b/platform-demos/C/window.py.page
index 10800f6..8a9df00 100644
--- a/platform-demos/C/window.py.page
+++ b/platform-demos/C/window.py.page
@@ -6,6 +6,7 @@
   <info>
     <title type="text">Window (Python)</title>
     <link type="guide" xref="beginner.py#windows"/>
+    <link type="next" xref="GtkApplicationWindow.py"/>
     <revision version="0.2" date="2012-06-09" status="draft"/>
 
     <credit type="author copyright">
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]