diff --git a/src/compositor/mutter-window.c b/src/compositor/mutter-window.c
index 7d9d91af2..13c9c4502 100644
--- a/src/compositor/mutter-window.c
+++ b/src/compositor/mutter-window.c
@@ -726,7 +726,7 @@ const char *mutter_window_get_description (MutterWindow *self)
 
 /**
  * mutter_window_get_workspace:
- * @self: #MutterWindow
+ * @mcw: #MutterWindow
  *
  * Returns the index of workspace on which this window is located; if the
  * window is sticky, or is not currently located on any workspace, returns -1.
@@ -737,7 +737,7 @@ const char *mutter_window_get_description (MutterWindow *self)
  * located.
  */
 gint
-mutter_window_get_workspace (MutterWindow *self)
+mutter_window_get_workspace (MutterWindow *mcw)
 {
   MutterWindowPrivate *priv;
   MetaWorkspace       *workspace;
diff --git a/src/core/workspace.c b/src/core/workspace.c
index e80ab8b5a..70fdf4c3d 100644
--- a/src/core/workspace.c
+++ b/src/core/workspace.c
@@ -706,7 +706,7 @@ meta_workspace_update_window_hints (MetaWorkspace *workspace)
 
 /**
  * meta_workspace_list_windows:
- * @display: a #MetaDisplay
+ * @workspace: a #MetaWorkspace
  *
  * Gets windows contained on the workspace, including workspace->windows
  * and also sticky windows. Override-redirect windows are not included.