diff --git a/src/core/display.c b/src/core/display.c
index 0bd245a92..9a041dcb7 100644
--- a/src/core/display.c
+++ b/src/core/display.c
@@ -23,7 +23,7 @@
 /**
  * SECTION:display
  * @title: MetaDisplay
- * @short_description: Mutter X display handler
+ * @short_description: Mutter display representation
  *
  * The display is represented as a #MetaDisplay struct.
  */
@@ -3610,7 +3610,7 @@ meta_display_focus_default_window (MetaDisplay *display,
  * meta_display_get_workspace_manager:
  * @display: a #MetaDisplay
  *
- * Returns: (transfer none) The workspace manager of the display
+ * Returns: (transfer none): The workspace manager of the display
  */
 MetaWorkspaceManager *
 meta_display_get_workspace_manager (MetaDisplay *display)
diff --git a/src/x11/meta-x11-display.c b/src/x11/meta-x11-display.c
index 485d04b88..c35f17336 100644
--- a/src/x11/meta-x11-display.c
+++ b/src/x11/meta-x11-display.c
@@ -21,7 +21,7 @@
  */
 
 /**
- * SECTION:display
+ * SECTION:x11-display
  * @title: MetaX11Display
  * @short_description: Mutter X display handler
  *