From a7562dd38fe86cfa26674f22d46fdfe24865ee13 Mon Sep 17 00:00:00 2001
From: Rico Tzschichholz <ricotz@ubuntu.com>
Date: Mon, 18 Aug 2014 13:27:05 +0200
Subject: [PATCH] docs: Fix broken gtk-doc formatting

Fixes broken introspection of GtkTranslateFunc
---
 gdk/gdkcairo.c                  |  2 +-
 gdk/wayland/gdkwindow-wayland.c |  2 +-
 gdk/x11/gdkmain-x11.c           |  4 ++--
 gtk/deprecated/gtkstock.h       |  2 +-
 gtk/gtkwidget.c                 | 10 +++++-----
 5 files changed, 10 insertions(+), 10 deletions(-)

diff --git a/gdk/gdkcairo.c b/gdk/gdkcairo.c
index 066f5c434d..b13c87a42a 100644
--- a/gdk/gdkcairo.c
+++ b/gdk/gdkcairo.c
@@ -378,7 +378,7 @@ gdk_cairo_set_source_window (cairo_t   *cr,
   cairo_surface_destroy (surface);
 }
 
-/*
+/**
  * _gdk_cairo_surface_extents:
  * @surface: surface to measure
  * @extents: (out): rectangle to put the extents
diff --git a/gdk/wayland/gdkwindow-wayland.c b/gdk/wayland/gdkwindow-wayland.c
index f26c3e0c3a..715b0cf22d 100644
--- a/gdk/wayland/gdkwindow-wayland.c
+++ b/gdk/wayland/gdkwindow-wayland.c
@@ -141,7 +141,7 @@ _gdk_window_impl_wayland_init (GdkWindowImplWayland *impl)
   impl->scale = 1;
 }
 
-/*
+/**
  * gdk_wayland_window_update_size:
  * @drawable: a #GdkDrawableImplWayland.
  *
diff --git a/gdk/x11/gdkmain-x11.c b/gdk/x11/gdkmain-x11.c
index 22c7b95519..460392510a 100644
--- a/gdk/x11/gdkmain-x11.c
+++ b/gdk/x11/gdkmain-x11.c
@@ -137,7 +137,7 @@ _gdk_x11_convert_grab_status (gint status)
   return 0;
 }
 
-/*
+/**
  * _gdk_x11_window_grab_check_unmap:
  * @window: a #GdkWindow
  * @serial: serial from Unmap event (or from NextRequest(display)
@@ -169,7 +169,7 @@ _gdk_x11_window_grab_check_unmap (GdkWindow *window,
   g_list_free (devices);
 }
 
-/*
+/**
  * _gdk_x11_window_grab_check_destroy:
  * @window: a #GdkWindow
  * 
diff --git a/gtk/deprecated/gtkstock.h b/gtk/deprecated/gtkstock.h
index e02115bcb3..13099c810a 100644
--- a/gtk/deprecated/gtkstock.h
+++ b/gtk/deprecated/gtkstock.h
@@ -34,7 +34,7 @@
 
 G_BEGIN_DECLS
 
-/*
+/**
  * GtkTranslateFunc:
  * @path: The id of the message. In #GtkActionGroup this will be a label
  *   or tooltip from a #GtkActionEntry.
diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index 383728d0b5..039bd12929 100644
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -12381,7 +12381,7 @@ is_my_window (GtkWidget *widget,
   return (user_data == widget);
 }
 
-/*
+/**
  * _gtk_widget_get_device_window:
  * @widget: a #GtkWidget
  * @device: a #GdkDevice
@@ -12429,7 +12429,7 @@ list_devices (GtkWidget        *widget,
   g_list_free (devices);
 }
 
-/*
+/**
  * _gtk_widget_list_devices:
  * @widget: a #GtkWidget
  *
@@ -12499,7 +12499,7 @@ synth_crossing (GtkWidget       *widget,
   gdk_event_free (event);
 }
 
-/*
+/**
  * _gtk_widget_synthesize_crossing:
  * @from: the #GtkWidget the virtual pointer is leaving.
  * @to: the #GtkWidget the virtual pointer is moving to.
@@ -12806,7 +12806,7 @@ static const GtkWidgetAuxInfo default_aux_info = {
   { 0, 0, 0, 0 }
 };
 
-/*
+/**
  * gtk_widget_get_aux_info:
  * @widget: a #GtkWidget
  * @create: if %TRUE, create the #GtkWidgetAuxInfo-struct if it doesn’t exist
@@ -15545,7 +15545,7 @@ union_with_clip (GtkWidget *widget,
   gdk_rectangle_union (&widget_clip, clip, clip);
 }
 
-/*
+/**
  * _gtk_widget_set_simple_clip:
  * @widget: a #GtkWidget
  *