From 25cdea33516b200b9740a091e4437e48c0607372 Mon Sep 17 00:00:00 2001 From: Vincent Sanders Date: Tue, 24 Jul 2012 16:19:49 +0100 Subject: doxygen serious warning cleanup --- desktop/browser.c | 9 +++++---- desktop/browser.h | 2 +- desktop/download.c | 3 ++- desktop/download.h | 3 ++- desktop/plot_style.c | 4 +++- 5 files changed, 13 insertions(+), 8 deletions(-) (limited to 'desktop') diff --git a/desktop/browser.c b/desktop/browser.c index 94330048a..bd819b412 100644 --- a/desktop/browser.c +++ b/desktop/browser.c @@ -1622,7 +1622,7 @@ void browser_window_update(struct browser_window *bw, bool scroll_to_top) browser_window_set_scroll(bw, 0, 0); /* if frag_id exists, then try to scroll to it */ - /** \TODO don't do this if the user has scrolled */ + /** @todo don't do this if the user has scrolled */ if (bw->frag_id && html_get_id_offset(bw->current_content, bw->frag_id, &x, &y)) { browser_window_set_scroll(bw, x, y); @@ -1641,7 +1641,7 @@ void browser_window_update(struct browser_window *bw, bool scroll_to_top) browser_window_set_scroll(bw, 0, 0); /* if frag_id exists, then try to scroll to it */ - /** \TODO don't do this if the user has scrolled */ + /** @todo don't do this if the user has scrolled */ if (bw->frag_id && html_get_id_offset(bw->current_content, bw->frag_id, &x, &y)) { browser_window_set_scroll(bw, x, y); @@ -1659,7 +1659,7 @@ void browser_window_update(struct browser_window *bw, bool scroll_to_top) browser_window_set_scroll(bw, 0, 0); /* if frag_id exists, then try to scroll to it */ - /** \TODO don't do this if the user has scrolled */ + /** @todo don't do this if the user has scrolled */ if (bw->frag_id && html_get_id_offset(bw->current_content, bw->frag_id, &x, &y)) { browser_window_set_scroll(bw, x, y); @@ -1849,7 +1849,8 @@ void browser_window_set_status(struct browser_window *bw, const char *text) /** * Change the shape of the mouse pointer * - * \param shape shape to use + * \param bw Browser window to set shape in + * \param shape The pointer shape to use */ void browser_window_set_pointer(struct browser_window *bw, diff --git a/desktop/browser.h b/desktop/browser.h index 09107a3e6..c8af7889c 100644 --- a/desktop/browser.h +++ b/desktop/browser.h @@ -202,7 +202,7 @@ struct browser_window { /** cache of the currently displayed status text. */ char *status_text; /**< Current status bar text. */ - int status_text_len; /**< Length of the ::status_text buffer. */ + int status_text_len; /**< Length of the browser_window::status_text buffer. */ int status_match; /**< Number of times an idempotent status-set operation was performed. */ int status_miss; /**< Number of times status was really updated. */ }; diff --git a/desktop/download.c b/desktop/download.c index fd91ed396..f4bedc8e9 100644 --- a/desktop/download.c +++ b/desktop/download.c @@ -17,7 +17,8 @@ */ /** - * \file Core download context (implementation) + * \file desktop/download.c + * \brief Core download context implementation */ #include diff --git a/desktop/download.h b/desktop/download.h index cbdf96718..f53f38b95 100644 --- a/desktop/download.h +++ b/desktop/download.h @@ -17,7 +17,8 @@ */ /** - * \file Core download context (interface) + * \file desktop/download.h + * \brief Core download context (interface) */ #ifndef NETSURF_DESKTOP_DOWNLOAD_H_ diff --git a/desktop/plot_style.c b/desktop/plot_style.c index 04d2885ff..85b898968 100644 --- a/desktop/plot_style.c +++ b/desktop/plot_style.c @@ -16,7 +16,9 @@ * along with this program. If not, see . */ -/** \file Plotter global styles. +/** + * \file desktop/plot_style.c + * \brief Plotter global styles. * * These plot styles are globaly available and used in many places. */ -- cgit v1.2.3