From 4ea25828a3704880e7291c8299114592a9d80d61 Mon Sep 17 00:00:00 2001
From: Mike Kestner <mkestner@gmail.com>
Date: Tue, 4 Jan 2005 19:19:57 +0000
Subject: [PATCH] 2005-01-04  Mike Kestner  <mkestner@novell.com>

	* gtk/Gtk.metadata : mark an out param for IMContext.GetSurrounding.
	[Fixes #70995]

svn path=/trunk/gtk-sharp/; revision=38322
---
 ChangeLog                |  5 +++++
 doc/en/Gtk/IMContext.xml | 32 ++++++++++++++++----------------
 gtk/Gtk.metadata         |  1 +
 3 files changed, 22 insertions(+), 16 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 0b08cbce0..7f522c767 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2005-01-04  Mike Kestner  <mkestner@novell.com>
+
+	* gtk/Gtk.metadata : mark an out param for IMContext.GetSurrounding.
+	[Fixes #70995]
+
 2005-01-04  Mike Kestner  <mkestner@novell.com>
 
 	* gtk/CellLayout.custom : declare SetAttributes and SetCellDataFunc.
diff --git a/doc/en/Gtk/IMContext.xml b/doc/en/Gtk/IMContext.xml
index 6f20b2bce..fa8b80ba1 100644
--- a/doc/en/Gtk/IMContext.xml
+++ b/doc/en/Gtk/IMContext.xml
@@ -71,32 +71,32 @@
         <summary>
 	  Asks the widget that the input context is attached to to delete
 	  characters around the cursor position by emitting the
-	  <see cref="E:Gtk.IMContext.DeleteSurrounding"/> signal. 
+	  <see cref="E:Gtk.IMContext.DeleteSurrounding" /> signal. 
 	</summary>
         <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" />, <see langword="true"/> if the signal was handled.</returns>
+        <returns>a <see cref="T:System.Boolean" />, <see langword="true" /> if the signal was handled.</returns>
         <remarks>
-	  <para>
-	    Note that <paramref name="offset"/> and <paramref name="n_chars"/>
+          <para>
+	    Note that <paramref name="offset" /> and <paramref name="n_chars" />
 	    are in characters not in bytes, which differs from the usage other
-	    places in <see cref="T:Gtk.IMContext"/>.
+	    places in <see cref="T:Gtk.IMContext" />.
 	  </para>
-	  <para>
+          <para>
 	    In order to use this function, you should first call
-	    <see cref="M:Gtk.IMContext.GetSurrounding"/>
+	    <see cref="M:Gtk.IMContext.GetSurrounding" />
 	    to get the current context, and
 	    call this function immediately afterwards to make sure that you
 	    know what you are deleting. You should also account for the fact
 	    that even if the signal was handled, the input context might not
 	    have deleted all the characters that were requested to be deleted.
 	  </para>
-	  <para>
+          <para>
 	    This function is used by an input method that wants to make
 	    subsitutions in the existing text in response to new input. It is
 	    not useful for applications.
 	  </para>
-	</remarks>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="FilterKeypress">
@@ -167,7 +167,7 @@
       <Docs>
         <summary>
 	  Set the client window for the input context; this is the
-	  <see cref="T:Gdk.Window"/> in which the input appears. 
+	  <see cref="T:Gdk.Window" /> in which the input appears. 
 	</summary>
         <param name="value">a <see cref="T:Gdk.Window" /></param>
         <returns>a <see cref="T:Gdk.Window" /></returns>
@@ -214,8 +214,8 @@
         <param name="value">a <see cref="T:System.Boolean" /></param>
         <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks>
-	  If <paramref name="use_preedit"/> is <see langword="false"/> (default
-	  is <see langword="true"/>), then the IM context may use some other method to display
+	  If <paramref name="use_preedit" /> is <see langword="false" /> (default
+	  is <see langword="true" />), then the IM context may use some other method to display
 	  feedback, such as displaying it in a child of the root window.
 	</remarks>
       </Docs>
@@ -310,19 +310,19 @@
       </Docs>
     </Member>
     <Member MemberName="GetSurrounding">
-      <MemberSignature Language="C#" Value="public bool GetSurrounding (string text, out int cursor_index);" />
+      <MemberSignature Language="C#" Value="public bool GetSurrounding (out string text, out int cursor_index);" />
       <MemberType>Method</MemberType>
       <ReturnValue>
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Parameters>
-        <Parameter Name="text" Type="System.String" />
+        <Parameter Name="text" Type="System.String&amp;" RefType="out" />
         <Parameter Name="cursor_index" Type="System.Int32&amp;" RefType="out" />
       </Parameters>
       <Docs>
-        <summary>To be added</summary>
+        <summary>Gets the context around the insertion point.</summary>
         <param name="text">a <see cref="T:System.String" /></param>
-        <param name="cursor_index">a <see cref="T:System.Int32&amp;" /></param>
+        <param name="cursor_index">a <see cref="T:System.Int32" /></param>
         <returns>a <see cref="T:System.Boolean" /></returns>
         <remarks />
       </Docs>
diff --git a/gtk/Gtk.metadata b/gtk/Gtk.metadata
index e4fd91cb7..e2a156949 100644
--- a/gtk/Gtk.metadata
+++ b/gtk/Gtk.metadata
@@ -195,6 +195,7 @@
   <attr path="/api/namespace/object[@cname='GtkImage']/method[@name='GetStock']/*/*[@name='stock_id']" name="pass_as">out</attr>
   <attr path="/api/namespace/object[@cname='GtkImage']/method[@name='SetFromPixmap']/*/*[@type='GdkBitmap*']" name="null_ok">1</attr>
   <attr path="/api/namespace/object[@cname='GtkIMContext']/signal[@name='DeleteSurrounding']" name="name">SurroundingDeleted</attr>
+  <attr path="/api/namespace/object[@cname='GtkIMContext']/method[@name='GetSurrounding']/*/*[@name='text']" name="pass_as">out</attr>
   <attr path="/api/namespace/object[@cname='GtkInvisible']/property[@name='Screen']" name="new_flag">1</attr>
   <attr path="/api/namespace/object[@cname='GtkItemFactory']/constructor[@cname='gtk_item_factory_new']" name="hidden">1</attr>
   <attr path="/api/namespace/object[@cname='GtkItemFactory']/method[@name='GetItemByAction']" name="name">GetItem</attr>