From 532ae96284c5d964c5afc4823a3c3425d06a0327 Mon Sep 17 00:00:00 2001
From: Shane Landrum <shane@mono-cvs.ximian.com>
Date: Mon, 13 Sep 2004 05:41:18 +0000
Subject: [PATCH] 2004-09-13 Shane Landrum <epicene@pobox.com>

	* en/Gtk/IMContext.xml
	* en/Gtk/IMContextInfo.xml
	* en/Gtk/IMContextSimple.xml
	* en/Gtk/IMMulticontext.xml
	* en/Gtk/IMPreeditStyle.xml
	* en/Gtk/IMStatusStyle.xml: Input-method-related classes.

svn path=/trunk/gtk-sharp/; revision=33795
---
 doc/ChangeLog                  |  9 +++++
 doc/en/Gtk/IMContext.xml       | 65 +++++++++++++++++++---------------
 doc/en/Gtk/IMContextInfo.xml   | 24 ++++++-------
 doc/en/Gtk/IMContextSimple.xml |  8 ++---
 doc/en/Gtk/IMMulticontext.xml  | 18 +++++-----
 doc/en/Gtk/IMPreeditStyle.xml  |  4 +--
 doc/en/Gtk/IMStatusStyle.xml   |  4 +--
 7 files changed, 75 insertions(+), 57 deletions(-)

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 51c6548d1..3c2126dc6 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,12 @@
+2004-09-13 Shane Landrum <epicene@pobox.com>
+
+	* en/Gtk/IMContext.xml
+	* en/Gtk/IMContextInfo.xml
+	* en/Gtk/IMContextSimple.xml
+	* en/Gtk/IMMulticontext.xml
+	* en/Gtk/IMPreeditStyle.xml
+	* en/Gtk/IMStatusStyle.xml: Input-method-related classes.
+	
 2004-09-13 Shane Landrum <epicene@pobox.com>
 
 	* en/Gtk/ChildNotifiedArgs.xml
diff --git a/doc/en/Gtk/IMContext.xml b/doc/en/Gtk/IMContext.xml
index 4efdd4b09..2818f97c4 100644
--- a/doc/en/Gtk/IMContext.xml
+++ b/doc/en/Gtk/IMContext.xml
@@ -11,7 +11,7 @@
   <ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
   <Docs>
     <summary>A base class for input method contexts.</summary>
-    <remarks>To be added</remarks>
+    <remarks/>
   </Docs>
   <Base>
     <BaseTypeName>GLib.Object</BaseTypeName>
@@ -34,8 +34,11 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary> Notify the input method that the widget to which this 
+	  input context corresponds has gained focus. The input method
+	  may, for example, change the displayed feedback to reflect
+	  this change.</summary>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="FocusOut">
@@ -46,8 +49,12 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <summary>Notify the input method that the widget to which this
+	  input context corresponds has lost focus. The input method
+	  may, for example, change the displayed feedback or reset the contexts
+	  state to reflect this change.
+	</summary>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="DeleteSurrounding">
@@ -62,10 +69,10 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="offset">To be added: an object of type 'int'</param>
-        <param name="n_chars">To be added: an object of type 'int'</param>
-        <returns>To be added: an object of type 'bool'</returns>
-        <remarks>To be added</remarks>
+        <param name="offset">a <see cref="T:System.Int32"/></param>
+        <param name="n_chars">a <see cref="T:System.Int32"/></param>
+        <returns>a <see cref="T:System.Boolean"/></returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="FilterKeypress">
@@ -135,9 +142,9 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'Gdk.Window'</param>
-        <returns>To be added: an object of type 'Gdk.Window'</returns>
-        <remarks>To be added</remarks>
+        <param name="value">a <see cref="T:Gdk.Window"/></param>
+        <returns>a <see cref="T:Gdk.Window"/></returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="CursorLocation">
@@ -150,9 +157,9 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'Gdk.Rectangle'</param>
-        <returns>To be added: an object of type 'Gdk.Rectangle'</returns>
-        <remarks>To be added</remarks>
+        <param name="value">a <see cref="T:Gdk.Rectangle"/></param>
+        <returns>a <see cref="T:Gdk.Rectangle"/></returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="UsePreedit">
@@ -165,9 +172,9 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="value">To be added: an object of type 'bool'</param>
-        <returns>To be added: an object of type 'bool'</returns>
-        <remarks>To be added</remarks>
+        <param name="value">a <see cref="T:System.Boolean"/></param>
+        <returns>a <see cref="T:System.Boolean"/></returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="PreeditChanged">
@@ -179,7 +186,7 @@
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="PreeditStart">
@@ -191,7 +198,7 @@
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="SurroundingDeleted">
@@ -203,7 +210,7 @@
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="Commit">
@@ -227,7 +234,7 @@
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="PreeditEnd">
@@ -239,7 +246,7 @@
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="SetSurrounding">
@@ -254,9 +261,9 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="text">To be added: an object of type 'string'</param>
-        <param name="cursor_index">To be added: an object of type 'int'</param>
-        <remarks>To be added</remarks>
+        <param name="text">a <see cref="T:System.String"/></param>
+        <param name="cursor_index">a <see cref="T:System.Int32"/></param>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="GetSurrounding">
@@ -274,7 +281,7 @@
         <param name="text">a <see cref="T:System.String" /></param>
         <param name="cursor_index">a <see cref="T:System.Int32&amp;" /></param>
         <returns>a <see cref="T:System.Boolean" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="GType">
@@ -401,7 +408,7 @@
         <param name="str">a <see cref="T:System.String" /></param>
         <param name="attrs">a <see cref="T:Pango.AttrList" /></param>
         <returns>a <see cref="T:System.Int32" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -416,4 +423,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/IMContextInfo.xml b/doc/en/Gtk/IMContextInfo.xml
index 3870afd7d..e6d357753 100644
--- a/doc/en/Gtk/IMContextInfo.xml
+++ b/doc/en/Gtk/IMContextInfo.xml
@@ -10,8 +10,8 @@
   </AssemblyInfo>
   <ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
   <Docs>
-    <summary>To be added</summary>
-    <remarks>To be added</remarks>
+    <summary>Helper class for <see cref="T:Gtk.IMContext"/>.</summary>
+    <remarks/>
   </Docs>
   <Base>
     <BaseTypeName>System.ValueType</BaseTypeName>
@@ -28,7 +28,7 @@
       <Parameters />
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="New">
@@ -42,9 +42,9 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <param name="raw">To be added: an object of type 'IntPtr'</param>
-        <returns>To be added: an object of type 'Gtk.IMContextInfo'</returns>
-        <remarks>To be added</remarks>
+        <param name="raw">a <see cref="T:IntPtr"/></param>
+        <returns>a <see cref="T:Gtk.IMContextInfo"/></returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="ContextId">
@@ -57,7 +57,7 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="ContextName">
@@ -70,7 +70,7 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="Domain">
@@ -83,7 +83,7 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="DomainDirname">
@@ -96,7 +96,7 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="DefaultLocales">
@@ -109,8 +109,8 @@
       </Parameters>
       <Docs>
         <summary>To be added</summary>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/IMContextSimple.xml b/doc/en/Gtk/IMContextSimple.xml
index 38df41017..bc6ad4941 100644
--- a/doc/en/Gtk/IMContextSimple.xml
+++ b/doc/en/Gtk/IMContextSimple.xml
@@ -11,7 +11,7 @@
   <ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
   <Docs>
     <summary>To be added</summary>
-    <remarks>To be added</remarks>
+    <remarks/>
   </Docs>
   <Base>
     <BaseTypeName>Gtk.IMContext</BaseTypeName>
@@ -62,7 +62,7 @@
       <Docs>
         <summary>To be added</summary>
         <returns>To be added: an object of type 'Gtk.IMContextSimple'</returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="GType">
@@ -107,8 +107,8 @@
         <param name="max_seq_len">a <see cref="T:System.Int32" /></param>
         <param name="n_seqs">a <see cref="T:System.Int32" /></param>
         <returns>a <see cref="T:System.UInt16" /></returns>
-        <remarks>To be added</remarks>
+        <remarks/>
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/IMMulticontext.xml b/doc/en/Gtk/IMMulticontext.xml
index e85fe6f52..5935e864a 100644
--- a/doc/en/Gtk/IMMulticontext.xml
+++ b/doc/en/Gtk/IMMulticontext.xml
@@ -11,7 +11,7 @@
   <ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
   <Docs>
     <summary>To be added</summary>
-    <remarks>To be added</remarks>
+    <remarks/>
   </Docs>
   <Base>
     <BaseTypeName>Gtk.IMContext</BaseTypeName>
@@ -36,9 +36,11 @@
         <Parameter Name="menushell" Type="Gtk.MenuShell" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
-        <param name="menushell">To be added: an object of type 'Gtk.MenuShell'</param>
-        <remarks>To be added</remarks>
+        <summary>Add menuitems for various available input methods to a menu;
+	  the menuitems, when selected, will switch the input method
+	  for the context and the global default input method.</summary>
+        <param name="menushell">a <see cref="T:Gtk.MenuShell"/></param>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="Finalize">
@@ -75,9 +77,9 @@
       <ReturnValue />
       <Parameters />
       <Docs>
-        <summary>To be added</summary>
-        <returns>To be added: an object of type 'Gtk.IMMulticontext'</returns>
-        <remarks>To be added</remarks>
+        <summary>Basic constructor.</summary>
+        <returns>a <see cref="T:Gtk.IMMulticontext"/></returns>
+        <remarks/>
       </Docs>
     </Member>
     <Member MemberName="GType">
@@ -108,4 +110,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/IMPreeditStyle.xml b/doc/en/Gtk/IMPreeditStyle.xml
index a5848a6ca..e57811354 100644
--- a/doc/en/Gtk/IMPreeditStyle.xml
+++ b/doc/en/Gtk/IMPreeditStyle.xml
@@ -11,7 +11,7 @@
   <ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
   <Docs>
     <summary>To be added</summary>
-    <remarks>To be added</remarks>
+    <remarks/>
   </Docs>
   <Base>
     <BaseTypeName>System.Enum</BaseTypeName>
@@ -71,4 +71,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>
diff --git a/doc/en/Gtk/IMStatusStyle.xml b/doc/en/Gtk/IMStatusStyle.xml
index 4d83b04d2..f6c20a419 100644
--- a/doc/en/Gtk/IMStatusStyle.xml
+++ b/doc/en/Gtk/IMStatusStyle.xml
@@ -11,7 +11,7 @@
   <ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
   <Docs>
     <summary>To be added</summary>
-    <remarks>To be added</remarks>
+    <remarks/>
   </Docs>
   <Base>
     <BaseTypeName>System.Enum</BaseTypeName>
@@ -71,4 +71,4 @@
       </Docs>
     </Member>
   </Members>
-</Type>
\ No newline at end of file
+</Type>