diff --git a/lib/mks-mouse.c b/lib/mks-mouse.c
index fcf0c1f..d6f42b8 100644
--- a/lib/mks-mouse.c
+++ b/lib/mks-mouse.c
@@ -389,7 +389,7 @@ mks_mouse_move_to_finish (MksMouse      *self,
 }
 
 /**
- * mks_mouse_move_to:
+ * mks_mouse_move_to_sync:
  * @self: an #MksMouse
  * @x: the x coordinate
  * @y: the y coordinate
@@ -486,7 +486,7 @@ mks_mouse_move_by_finish (MksMouse      *self,
 }
 
 /**
- * mks_mouse_move_by:
+ * mks_mouse_move_by_sync:
  * @self: an #MksMouse
  * @delta_x: the x coordinate delta
  * @delta_y: the y coordinate delta
diff --git a/lib/mks-screen.c b/lib/mks-screen.c
index 27c6cbb..8ff56ec 100644
--- a/lib/mks-screen.c
+++ b/lib/mks-screen.c
@@ -729,6 +729,18 @@ mks_screen_attach_finish (MksScreen     *self,
   return g_task_propagate_pointer (G_TASK (result), error);
 }
 
+/**
+ * mks_screen_attach_sync:
+ * @self: a #MksScreen
+ * @cancellable: (nullable): a #GCancellable or %NULL
+ * @error: (nullable): a location for a #GError, or %NULL
+ *
+ * Synchronous request to attach to screen, creating a paintable that can
+ * be used to update display as the Qemu instance updates.
+ *
+ * Returns: (transfer full): a #GdkPaintable if successful; otherwise %NULL
+ *   and @error is set.
+ */
 GdkPaintable *
 mks_screen_attach_sync (MksScreen     *self,
                         GCancellable  *cancellable,
diff --git a/lib/mks-screen.h b/lib/mks-screen.h
index 7e2ce95..c6a1677 100644
--- a/lib/mks-screen.h
+++ b/lib/mks-screen.h
@@ -81,7 +81,7 @@ gboolean       mks_screen_configure_sync     (MksScreen            *self,
                                               GCancellable         *cancellable,
                                               GError              **error);
 MKS_AVAILABLE_IN_ALL
-void           mks_screen_attach             (MksScreen            *screen,
+void           mks_screen_attach             (MksScreen            *self,
                                               GCancellable         *cancellable,
                                               GAsyncReadyCallback   callback,
                                               gpointer              user_data);
@@ -90,7 +90,7 @@ GdkPaintable  *mks_screen_attach_finish      (MksScreen            *self,
                                               GAsyncResult         *result,
                                               GError              **error);
 MKS_AVAILABLE_IN_ALL
-GdkPaintable  *mks_screen_attach_sync        (MksScreen            *screen,
+GdkPaintable  *mks_screen_attach_sync        (MksScreen            *self,
                                               GCancellable         *cancellable,
                                               GError              **error);