[Mono-docs-list] small monkeyguide patch

Kris Luyten kris.luyten@luc.ac.be
Sun, 24 Aug 2003 03:03:25 +0200

Content-Type: text/plain
Content-Transfer-Encoding: 7bit


in the attachment is a small patch for the monkeyguide docs. I fixed
some typo's and rewrote some sentences in the gtk-sharp part. It is not
much though (hopefully I'll be able to do some more in the future).

I made the patch with diff as follows: "diff -ur
monkeyguide/html/en/gnome monkeyguide-working/html/en/gnome > docs-`date
+%d%m%Y`.diff" against a fresh checkout of the CVS monkeyguide. Is this
the correct way to submit a diff for the docs?

As a side question: why is the monkeyguide direclty written in HTML, and
not in Docbook for example?

Kris Luyten
Expertisecentrum Digitale Media - Limburgs Universitair Centrum
Wetenschapspark 2, 3590 Diepenbeek (Belgium)
email: kris.luyten@luc.ac.be
PGP-key: http://lumumba.luc.ac.be/kris/kris-pub.txt
homepage: http://lumumba.luc.ac.be/kris/

Content-Disposition: attachment; filename=docs-24082003.diff
Content-Type: text/x-patch; name=docs-24082003.diff; charset=ISO-8859-1
Content-Transfer-Encoding: 7bit

diff -ur monkeyguide/html/en/gnome/CVS/Entries monkeyguide-working/html/en/gnome/CVS/Entries
--- monkeyguide/html/en/gnome/CVS/Entries	Mon Aug 18 10:05:50 2003
+++ monkeyguide-working/html/en/gnome/CVS/Entries	Thu Aug 14 14:03:30 2003
@@ -3,5 +3,4 @@
 /gn.png/1.2/Sun Jan 12 16:51:41 2003/-kb/
 /installation.html/1.7/Wed Jun 11 17:50:10 2003//
 /introduction.html/1.6/Wed Jun 11 17:50:10 2003//
Only in monkeyguide-working/html/en/gnome/CVS: Entries.Log
diff -ur monkeyguide/html/en/gnome/bindings/CVS/Entries monkeyguide-working/html/en/gnome/bindings/CVS/Entries
--- monkeyguide/html/en/gnome/bindings/CVS/Entries	Mon Aug 18 10:05:48 2003
+++ monkeyguide-working/html/en/gnome/bindings/CVS/Entries	Thu Aug 14 14:03:30 2003
@@ -1,7 +1 @@
Only in monkeyguide-working/html/en/gnome/bindings/CVS: Entries.Log
diff -ur monkeyguide/html/en/gnome/bindings/gnome/CVS/Entries monkeyguide-working/html/en/gnome/bindings/gnome/CVS/Entries
--- monkeyguide/html/en/gnome/bindings/gnome/CVS/Entries	Mon Aug 18 10:05:48 2003
+++ monkeyguide-working/html/en/gnome/bindings/gnome/CVS/Entries	Thu Aug 14 14:03:31 2003
@@ -2,5 +2,4 @@
 /gnome.html/1.10/Thu Jun 26 18:01:07 2003//
 /hello_world.html/1.8/Wed Jun 11 17:50:12 2003//
 /introduction.html/1.5/Thu Jun 26 19:33:02 2003//
Only in monkeyguide-working/html/en/gnome/bindings/gnome/CVS: Entries.Log
diff -ur monkeyguide/html/en/gnome/bindings/gtk-sharp/packingdetails.html monkeyguide-working/html/en/gnome/bindings/gtk-sharp/packingdetails.html
--- monkeyguide/html/en/gnome/bindings/gtk-sharp/packingdetails.html	Thu Jun 26 23:17:38 2003
+++ monkeyguide-working/html/en/gnome/bindings/gtk-sharp/packingdetails.html	Sat Aug 16 11:53:49 2003
@@ -14,7 +14,7 @@
 <h2>Packing Widgets Sample</h2>
 Because of this flexibility, packing boxes in GTK can be confusing
-at first. There are a lot of options, and it's not immediately
+at first. There are a lot of options, and it is not immediately
 obvious how they all fit together. In the end, however, there are
 basically five different styles. 
 <p><img src="packbox.png" border="0" /></p>
diff -ur monkeyguide/html/en/gnome/bindings/gtk-sharp/packingwidgetstheory.html monkeyguide-working/html/en/gnome/bindings/gtk-sharp/packingwidgetstheory.html
--- monkeyguide/html/en/gnome/bindings/gtk-sharp/packingwidgetstheory.html	Thu Jun 26 23:17:38 2003
+++ monkeyguide-working/html/en/gnome/bindings/gtk-sharp/packingwidgetstheory.html	Sat Aug 16 11:48:46 2003
@@ -21,17 +21,19 @@
 While this is more difficult for a newcomer it has some
-<li>Independent of screesize</li>
+<li>Independent of screensize</li>
 <li>Easier Internationalization</li></ul>
-<p>There are other kind of methods to pack widgets that is using
-packing widgets. There are two boxes: vbox and hbox. The creation
-of that is too simple, only you have to create an instance of HBox
-or VBox like the Button widgets.</p>
-<p>Two important methods of that packing boxes are PackStart and
-PackEnd, these methods packing the element beginning with the top
-to the button and the second will do button to up in VBox. In HBox
-you package the samples left to right with PackStart and right to
-left with PackEnd.</p>
+<p>There is another kind of method to pack widgets; using
+the packing widgets. There are two kind of boxes available
+for packing widgets: vbox and hbox. The creation
+of these boxes is vry simple, you only have to create an instance of an HBox
+or VBox objects (just like creating a new Gtk.Button for example).</p>
+<p>Two important methods of packing boxes are PackStart and
+PackEnd. When using the VBox packing widget, PackStart will add widgets from the top to the bottom.
+PackEnd will add widgets beginning with the bottom to the top.
+When using the HBox packing widget, PackStart will add widgets from the left to the right.
+PackEnd will add widgets beginning with the right side to the left.</p>
 <p>By using these calls, GTK knows where you want to place your
 widgets so it can do automatic resizing and other nifty things.
 There are also a number of options as to how your widgets should be
diff -ur monkeyguide/html/en/gnome/bindings/gtk-sharp/widgetoverview.html monkeyguide-working/html/en/gnome/bindings/gtk-sharp/widgetoverview.html
--- monkeyguide/html/en/gnome/bindings/gtk-sharp/widgetoverview.html	Thu Jun 26 23:17:38 2003
+++ monkeyguide-working/html/en/gnome/bindings/gtk-sharp/widgetoverview.html	Sat Aug 16 11:58:46 2003
@@ -13,25 +13,25 @@
 &gt; C# bindings &gt; <b>Gtk#</b></div>
 <h2>Widget Overview</h2>
-<p>The general steps to creating a widget in GTK are:</p>
+<p>The general steps for creating a widget in GTK are:</p>
 <li>1. new Gtk.*() - one of various functions to create a new
-widget. These are all detailed in this section.</li>
+widget. These are all discussed into detail in this section.</li>
 <li>2. Connect all signals and events we wish to use to the
 appropriate handlers.</li>
 <li>3. Set the attributes of the widget.</li>
 <li>4. Pack the widget into a container using the appropriate call
-such as gtk_container_add() or gtk_box_pack_start().</li>
+such as Gtk.Container.Add() or Gtk.Box.PackStart().</li>
 <li>5. *.Show() the widget.</li>
-<li>6. gtk_widget_show() lets GTK know that we are done setting the
+<li>6. Gtk.Widget.Show() lets GTK know that we are done setting the
 attributes of the widget, and it is ready to be displayed. You may
-also use gtk_widget_hide to make it disappear again. The order in
+also use Gtk.Widget.Hide() to make it disappear again. The order in
 which you show the widgets is not important, but I suggest showing
 the window last so the whole window pops up at once rather than
 seeing the individual widgets come up on the screen as they're
 formed. The children of a widget (a window is a widget too) will
 not be displayed until the window itself is shown using the
-gtk_widget_show() function.</li></ul>
+Gtk.Widget.Show() function.</li></ul>
 <div class="copyright">The Mono Handbook -
 <a href="http://www.go-mono.org">&#169; Copyright 2002 by Johannes
 Roith &amp; Martin Willemoes Hansen</a></div>
diff -ur monkeyguide/html/en/gnome/bindings/gtk-sharp/widgetoverviewhierarchy.html monkeyguide-working/html/en/gnome/bindings/gtk-sharp/widgetoverviewhierarchy.html
--- monkeyguide/html/en/gnome/bindings/gtk-sharp/widgetoverviewhierarchy.html	Thu Jun 26 23:17:38 2003
+++ monkeyguide-working/html/en/gnome/bindings/gtk-sharp/widgetoverviewhierarchy.html	Sat Aug 16 11:59:38 2003
@@ -12,9 +12,7 @@
 Mono Handbook</a> &gt; <a href="../../index.html">GNOME.NET</a>
 &gt; C# bindings &gt; <b>Gtk#</b></div>
-<h2>Widget Overview</h2>
-<p>The general steps to creating a widget in GTK are:</p>
-<h3>Widget Hierarchy</h3>
+<h2>Widget Hierarchy</h2>
 Here is the class hierarchy tree used to implement widgets: 
 <pre class="code">
Only in monkeyguide-working/html/en/gnome: documentation