From 459387017890bc19a347ae674f8c105d6cfc62d0 Mon Sep 17 00:00:00 2001
From: Bertrand Lorentz <bertrand.lorentz@gmail.com>
Date: Wed, 4 Dec 2013 20:42:05 +0100
Subject: [PATCH] doc: Add a bit of documentation for Widget.OnDrawn

---
 doc/en/Gtk/Widget.xml | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/doc/en/Gtk/Widget.xml b/doc/en/Gtk/Widget.xml
index e10b377a3..e01001a23 100644
--- a/doc/en/Gtk/Widget.xml
+++ b/doc/en/Gtk/Widget.xml
@@ -1226,7 +1226,7 @@ class TestClose
         <ReturnType>Gtk.DrawnHandler</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Raised when the widget needs to be fully or partially redrawn.</summary>
         <remarks>To be added.</remarks>
         <since version="Gtk# 3.0" />
       </Docs>
@@ -3500,10 +3500,10 @@ To change the font of a simple Widget:
         <Parameter Name="cr" Type="Cairo.Context" />
       </Parameters>
       <Docs>
-        <param name="cr">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="cr">a <see cref="T:Cairo.Context" /> to be used to paint the widget.</param>
+        <summary>Default handler for the <see cref="M:Gtk.Widget.Drawn" /> event.</summary>
+        <returns>a <see cref="T:System.Boolean" /></returns>
+        <remarks>Override this method in a subclass to provide a default handler for the <see cref="M:Gtk.Widget.Drawn" /> event. The <see cref="T:Cairo.Context" /> will be disposed after this method returns, so you should no keep a reference to it outside of the scope of this method.</remarks>
         <since version="Gtk# 3.0" />
       </Docs>
     </Member>