[gnome-builder/gnome-builder-3-18] build: add Workbench to gir/vapi

[Christian Hergert <chergert src gnome org>]

commit 200d354a8841a08d3be1d508bfc62bdad75c02b2
Author: Christian Hergert <christian hergert me>
Date:   Tue Sep 29 14:38:00 2015 -0700

    build: add Workbench to gir/vapi
    
    I would like to rethink what the "workbench" vs "workspace" is this
    cycle. I'm pretty unhappy with the current design.

 src/Makefile.am              |    4 ++--
 src/workbench/gb-workbench.c |   33 +++++++++++++++++++++++++++++++++
 2 files changed, 35 insertions(+), 2 deletions(-)
---
diff --git a/src/Makefile.am b/src/Makefile.am
index 0bb7be5..fe8170c 100644
--- a/src/Makefile.am
+++ b/src/Makefile.am
@@ -33,6 +33,8 @@ libgnome_builder_public_sources = \
        views/gb-view.h \
        views/gb-view-stack.c \
        views/gb-view-stack.h \
+       workbench/gb-workbench.c \
+       workbench/gb-workbench.h \
        $(NULL)
 
 libgnome_builder_la_SOURCES = \
@@ -173,8 +175,6 @@ libgnome_builder_la_SOURCES = \
        workbench/gb-workbench-addin.h \
        workbench/gb-workbench-private.h \
        workbench/gb-workbench-types.h \
-       workbench/gb-workbench.c \
-       workbench/gb-workbench.h \
        workspace/gb-workspace.c \
        workspace/gb-workspace.h \
        workspace/gb-workspace-pane.c \
diff --git a/src/workbench/gb-workbench.c b/src/workbench/gb-workbench.c
index 292b8ad..7186320 100644
--- a/src/workbench/gb-workbench.c
+++ b/src/workbench/gb-workbench.c
@@ -1020,6 +1020,14 @@ gb_workbench_get_closing (GbWorkbench *self)
   return (self->unloading || (self->disposing > 0));
 }
 
+/**
+ * gb_workbench_views_foreach:
+ * @self: A #GbWorkbench.
+ * @callback: (scope call): A callback to call for each view.
+ * @callback_data: (closure callback): User data for @callback.
+ *
+ * Invoke @callback for each view in the workbench.
+ */
 void
 gb_workbench_views_foreach (GbWorkbench *self,
                             GtkCallback  callback,
@@ -1051,6 +1059,13 @@ gb_workbench_views_foreach (GbWorkbench *self,
   g_list_free (stacks);
 }
 
+/**
+ * gb_workbench_get_workspace:
+ *
+ *
+ *
+ * Returns: (transfer none): The workspace widget.
+ */
 GtkWidget *
 gb_workbench_get_workspace (GbWorkbench *self)
 {
@@ -1059,6 +1074,11 @@ gb_workbench_get_workspace (GbWorkbench *self)
   return GTK_WIDGET (self->workspace);
 }
 
+/**
+ * gb_workbench_get_view_grid:
+ *
+ * Returns: (transfer none): The view grid for documents and such.
+ */
 GtkWidget *
 gb_workbench_get_view_grid (GbWorkbench *self)
 {
@@ -1152,6 +1172,14 @@ gb_workbench_reveal_file (GbWorkbench *self,
   gb_tree_node_select (node);
 }
 
+/**
+ * gb_workbench_get_slider:
+ *
+ * The slider can be used to to hide things behind the workbench and then
+ * reveal them efficiently.
+ *
+ * Returns: (transfer none): the toplevel slider
+ */
 GtkWidget *
 gb_workbench_get_slider (GbWorkbench *self)
 {
@@ -1160,6 +1188,11 @@ gb_workbench_get_slider (GbWorkbench *self)
   return GTK_WIDGET (self->slider);
 }
 
+/**
+ * gb_workbench_get_active_view:
+ *
+ * Returns: (transfer none): The last focused view.
+ */
 GtkWidget *
 gb_workbench_get_active_view (GbWorkbench *self)
 {