1 files changed, 170 insertions, 0 deletions
diff --git a/docs/reference/gtk/tmpl/gtkhandlebox.sgml b/docs/reference/gtk/tmpl/gtkhandlebox.sgml
new file mode 100644
index 0000000000..fdc52202fd
--- /dev/null
+++ b/docs/reference/gtk/tmpl/gtkhandlebox.sgml
@@ -0,0 +1,170 @@
+<!-- ##### SECTION Title ##### -->
+GtkHandleBox
+
+<!-- ##### SECTION Short_Description ##### -->
+a widget for  detachable window portions.
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+The #GtkHandleBox widget allows a portion of a window to be "torn
+off". It is a bin widget which displays its child and a handle that
+the user can drag to tear off a separate window (the <firstterm>float
+window</firstterm>) containing the child widget. A thin
+<firstterm>ghost</firstterm> is drawn in the original location of the
+handlebox. By dragging the separate window back to its original
+location, it can be reattached.
+</para>
+<para>
+When reattaching, the ghost and float window, must be aligned
+along one of the edges, the <firstterm>snap edge</firstterm>.
+This either can be specified by the application programmer
+explicitely, or GTK+ will pick a reasonable default based
+on the handle position.
+</para>
+<para>
+To make detaching and reattaching the handlebox as minimally confusing
+as possible to the user, it is important to set the snap edge so that
+the snap edge does not move when the handlebox is deattached. For
+instance, if the handlebox is packed at the bottom of a VBox, then
+when the handlebox is detached, the bottom edge of the handlebox's
+allocation will remain fixed as the height of the handlebox shrinks,
+so the snap edge should be set to %GTK_POS_BOTTOM.
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### STRUCT GtkHandleBox ##### -->
+<para>
+The #GtkHandleBox-struct struct contains the following fields.
+(These fields should be considered read-only. They should never be set by
+an application.)
+
+<informaltable pgwide=1 frame="none" role="struct">
+<tgroup cols="2"><colspec colwidth="2*"><colspec colwidth="8*">
+<tbody>
+
+<row>
+<entry>GtkShadowType shadow_type;</entry>
+<entry>The shadow type for the entry. (See gtk_handle_box_set_shadow_type()).</entry>
+</row>
+
+<row>
+<entry>GtkPositionType handle_position;</entry>
+<entry>The position of the handlebox's handle with respect
+to the child. (See gtk_handle_box_set_handle_position())</entry>
+</row>
+
+<row>
+<entry>gint snap_edge;</entry>
+<entry>A value of type #GtkPosition type indicating snap edge for the widget.
+(See gtk_handle_box_set_snap_edge). The value of -1 indicates
+that this value has not been set.
+
+<row>
+<entry>#gboolean child_detached;</entry>
+<entry>A boolean value indicating whether the handlebox's
+child is attached or detached.</entry>
+</row>
+
+</tbody>
+</tgroup>
+</informaltable>
+
+</para>
+
+@bin: 
+@bin_window: 
+@float_window: 
+@shadow_type: 
+@handle_position: 
+@float_window_mapped: 
+@child_detached: 
+@in_drag: 
+@shrink_on_detach: 
+@snap_edge: 
+@deskoff_x: 
+@deskoff_y: 
+@attach_allocation: 
+@float_allocation: 
+
+<!-- ##### FUNCTION gtk_handle_box_new ##### -->
+<para>
+Create a new handle box.
+</para>
+
+@Returns: a new #GtkHandleBox.
+
+
+<!-- ##### FUNCTION gtk_handle_box_set_shadow_type ##### -->
+<para>
+Sets the type of shadow to be drawn around the border
+of the 
+</para>
+
+@handle_box: a #GtkHandleBox
+@type: the shadow type.
+
+
+<!-- ##### FUNCTION gtk_handle_box_set_handle_position ##### -->
+<para>
+Sets the side of the handlebox where the handle is drawn.
+</para>
+
+@handle_box: a #GtkHandleBox
+@position: the side of the handlebox where the handle should be drawn.
+
+
+<!-- ##### FUNCTION gtk_handle_box_set_snap_edge ##### -->
+<para>
+Sets the snap edge of a handlebox. The snap edge is
+the edge of the detached child that must be aligned
+with the corresponding edge of the "ghost" left
+behind when the child was detached to reattach
+the torn-off window. Usually, the snap edge should
+be chosen so that it stays in the same place on
+the screen when the handlebox is torn off.
+</para>
+<para>
+If the snap edge is not set, then an appropriate value
+will be guessed from the handle position. If the
+handle position is %GTK_POS_RIGHT or %GTK_POS_LEFT,
+then the snap edge will be %GTK_POS_TOP, otherwise
+it will be %GTK_POS_LEFT.
+</para>
+
+@handle_box: a #GtkHandleBox
+@edge: the snap edge, or -1 to unset the value; in which
+case GTK+ will try to guess an appropriate value
+in the future.
+
+
+<!-- ##### SIGNAL GtkHandleBox::child-attached ##### -->
+<para>
+This signal is emitted when the contents of the
+handlebox are reattached to the main window.
+</para>
+
+@handlebox: the object which received the signal.
+@widget: the child widget of the handlebox.
+         (this argument provides no extra information
+          and is here only for backwards-compatibility)
+
+<!-- ##### SIGNAL GtkHandleBox::child-detached ##### -->
+<para>
+This signal is emitted when the contents of the
+handlebox are detached from the main window.
+</para>
+
+@handlebox: the object which received the signal.
+@widget: the child widget of the handlebox. 
+         (this argument provides no extra information
+          and is here only for backwards-compatibility)
+
+<!-- ##### ARG GtkHandleBox:shadow ##### -->
+<para>
+Determines the shadow type for the handlebox.
+</para>
+