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>