diff --git a/docs/reference/gtk/getting_started.xml b/docs/reference/gtk/getting_started.xml
index 3698aa5e90..aebc5ee42f 100644
--- a/docs/reference/gtk/getting_started.xml
+++ b/docs/reference/gtk/getting_started.xml
@@ -116,4 +116,35 @@
+
+ Packing
+
+ When creating an application, you'll want to put more than one widget
+ inside a window. Our first helloworld example only used one widget so we
+ could simply use a gtk_container_add() call to "pack" the widget into the
+ window. But when you want to put more than one widget into a window, it
+ it becomes important to control how each widget is positioned and sized.
+ This is where packing comes in.
+
+ GTK+ comes with a large variety of layout containers
+ whose purpose it is to control the layout of the child widgets that are
+ added to them. See for an overview.
+
+ The following example shows how the GtkGrid container lets you
+ arrange several buttons:
+
+
+
+
+
+
+ Packing buttons
+
+
+ FIXME: MISSING XINCLUDE CONTENT
+
+
+
+
+
diff --git a/docs/reference/gtk/images/grid-packing.png b/docs/reference/gtk/images/grid-packing.png
new file mode 100644
index 0000000000..3dec7d5fcd
Binary files /dev/null and b/docs/reference/gtk/images/grid-packing.png differ
diff --git a/examples/Makefile.am b/examples/Makefile.am
index 2d2a491695..f4d06bfd41 100644
--- a/examples/Makefile.am
+++ b/examples/Makefile.am
@@ -48,4 +48,4 @@ LDADD = \
$(top_builddir)/gtk/libgtk-3.0.la \
$(GTK_DEP_LIBS)
-noinst_PROGRAMS = hello-world window-default bloatpad
+noinst_PROGRAMS = hello-world window-default bloatpad grid-packing
diff --git a/examples/grid-packing.c b/examples/grid-packing.c
new file mode 100644
index 0000000000..9943babac7
--- /dev/null
+++ b/examples/grid-packing.c
@@ -0,0 +1,73 @@
+#include
+
+static void
+print_hello (GtkWidget *widget,
+ gpointer data)
+{
+ g_print ("Hello World\n");
+}
+
+int
+main (int argc,
+ char *argv[])
+{
+ GtkWidget *window;
+ GtkWidget *grid;
+ GtkWidget *button;
+
+ /* This is called in all GTK applications. Arguments are parsed
+ * from the command line and are returned to the application.
+ */
+ gtk_init (&argc, &argv);
+
+ /* create a new window, and set its title */
+ window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
+ gtk_window_set_title (GTK_WINDOW (window), "Grid");
+ g_signal_connect (window, "destroy", G_CALLBACK (gtk_main_quit), NULL);
+ gtk_container_set_border_width (GTK_CONTAINER (window), 10);
+
+ /* Here we construct the container that is going pack our buttons */
+ grid = gtk_grid_new ();
+
+ /* Pack the container in the window */
+ gtk_container_add (GTK_CONTAINER (window), grid);
+
+ button = gtk_button_new_with_label ("Button 1");
+ g_signal_connect (button, "clicked", G_CALLBACK (print_hello), NULL);
+
+ /* Place the first button in the grid cell (0, 0), and make it fill
+ * just 1 cell horizontally and vertically (ie no spanning)
+ */
+ gtk_grid_attach (GTK_GRID (grid), button, 0, 0, 1, 1);
+
+ button = gtk_button_new_with_label ("Button 2");
+ g_signal_connect (button, "clicked", G_CALLBACK (print_hello), NULL);
+
+ /* Place the second button in the grid cell (1, 0), and make it fill
+ * just 1 cell horizontally and vertically (ie no spanning)
+ */
+ gtk_grid_attach (GTK_GRID (grid), button, 1, 0, 1, 1);
+
+ button = gtk_button_new_with_label ("Quit");
+ g_signal_connect (button, "clicked", G_CALLBACK (gtk_main_quit), NULL);
+
+ /* Place the Quit button in the grid cell (0, 1), and make it
+ * span 2 columns.
+ */
+ gtk_grid_attach (GTK_GRID (grid), button, 0, 1, 2, 1);
+
+ /* Now that we are done packing our widgets, we show them all
+ * in one go, by calling gtk_widget_show_all() on the window.
+ * This call recursively calls gtk_widget_show() on all widgets
+ * that are contained in the window, directly or indirectly.
+ */
+ gtk_widget_show_all (window);
+
+ /* All GTK applications must have a gtk_main(). Control ends here
+ * and waits for an event to occur (like a key press or a mouse event),
+ * until gtk_main_quit() is called.
+ */
+ gtk_main ();
+
+ return 0;
+}