doxygen serious warning cleanup

content/urldb.c

@@ -167,7 +167,7 @@ struct path_data {
 				 * the default port for given scheme, i.e.
 				 * 80 (http), 443 (https). */
 	char *segment;		/**< Path segment for this node */
-	unsigned int frag_cnt;	/**< Number of entries in ::fragment */
+	unsigned int frag_cnt;	/**< Number of entries in path_data::fragment */
 	char **fragment;	/**< Array of fragments */
 	bool persistent;	/**< This entry should persist */
 

css/select.c

@@ -3367,7 +3367,7 @@ bool parse_number(const char *data, bool maybe_negative, bool real,
 }
 
 /**
- * Parse a font @size attribute
+ * Parse a font \@size attribute
  *
  * \param size  Data to parse (NUL-terminated)
  * \param val   Pointer to location to receive enum value

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,

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. */
 };

desktop/download.c

@@ -17,7 +17,8 @@
  */
 
 /**
- * \file Core download context (implementation)
+ * \file desktop/download.c
+ * \brief Core download context implementation
  */
 
 #include <assert.h>

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_

desktop/plot_style.c

@@ -16,7 +16,9 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/** \file Plotter global styles.
+/** 
+ * \file desktop/plot_style.c
+ * \brief Plotter global styles.
  *
  * These plot styles are globaly available and used in many places.
  */

render/box.h

@@ -283,7 +283,7 @@ struct column {
 	bool positioned;
 };
 
-/** Parameters for <object> and similar elements. */
+/** Parameters for object element and similar elements. */
 struct object_params {
 	nsurl *data;
 	char *type;
@@ -293,7 +293,7 @@ struct object_params {
 	struct object_param *params;
 };
 
-/** Linked list of <object> parameters. */
+/** Linked list of object element parameters. */
 struct object_param {
 	char *name;
 	char *value;

utils/filepath.h

@@ -16,7 +16,10 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/** \file Utility routines to obtain paths to file resources. */
+/** 
+ * \file utils/filepath.h
+ * \brief Utility routines to obtain paths to file resources. 
+ */
 
 #ifndef _NETSURF_UTILS_FILEPATH_H_
 #define _NETSURF_UTILS_FILEPATH_H_

utils/url.h

@@ -17,17 +17,20 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/** \file
- * URL parsing and joining (interface).
+/** 
+ * \file utils/url.h
+ * \brief URL parsing and joining (interface).
  */
 
 #ifndef _NETSURF_UTILS_URL_H_
 #define _NETSURF_UTILS_URL_H_
 
-/* file url prefix */
+/** File url prefix */
 #define FILE_SCHEME_PREFIX "file:///"
+/** File url prefix length */
 #define FILE_SCHEME_PREFIX_LEN 8
 
+/** URL utility function return codes */
 typedef enum {
 	URL_FUNC_OK,     /**< No error */
 	URL_FUNC_NOMEM,  /**< Insufficient memory */