From d2742077b95cdc574c0b88284e5d04243de0ff9d Mon Sep 17 00:00:00 2001
From: Vincent Sanders <vince@kyllikki.org>
Date: Sat, 24 Dec 2016 23:25:11 +0000
Subject: [PATCH] improve corewindow API documentation

---
 include/netsurf/core_window.h | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/include/netsurf/core_window.h b/include/netsurf/core_window.h
index 274c757e3..b6b012049 100644
--- a/include/netsurf/core_window.h
+++ b/include/netsurf/core_window.h
@@ -47,34 +47,34 @@ struct core_window_callback_table {
 	/**
 	 * Request a redraw of the window
 	 *
-	 * \param cw		the core window object
-	 * \param r		rectangle to redraw
+	 * \param[in] cw the core window object
+	 * \param[in] r rectangle to redraw
 	 */
 	void (*redraw_request)(struct core_window *cw, const struct rect *r);
 
 	/**
 	 * Update the limits of the window
 	 *
-	 * \param cw		the core window object
-	 * \param width		the width in px, or negative if don't care
-	 * \param height	the height in px, or negative if don't care
+	 * \param[in] cw the core window object
+	 * \param[in] width the width in px, or negative if don't care
+	 * \param[in] height the height in px, or negative if don't care
 	 */
 	void (*update_size)(struct core_window *cw, int width, int height);
 
 	/**
 	 * Scroll the window to make area visible
 	 *
-	 * \param cw		the core window object
-	 * \param r		rectangle to make visible
+	 * \param[in] cw the core window object
+	 * \param[in] r rectangle to make visible
 	 */
 	void (*scroll_visible)(struct core_window *cw, const struct rect *r);
 
 	/**
 	 * Get window viewport dimensions
 	 *
-	 * \param cw		the core window object
-	 * \param width		to be set to viewport width in px, if non NULL
-	 * \param height	to be set to viewport height in px, if non NULL
+	 * \param[in] cw the core window object
+	 * \param[out] width to be set to viewport width in px
+	 * \param[out] height to be set to viewport height in px
 	 */
 	void (*get_window_dimensions)(struct core_window *cw,
 			int *width, int *height);
@@ -82,8 +82,8 @@ struct core_window_callback_table {
 	/**
 	 * Inform corewindow owner of drag status
 	 *
-	 * \param cw		the core window object
-	 * \param ds		the current drag status
+	 * \param[in] cw the core window object
+	 * \param[in] ds the current drag status
 	 */
 	void (*drag_status)(struct core_window *cw,
 			core_window_drag_status ds);