From f287379a7cca0717166119ecbf15b4e2dcdbfc56 Mon Sep 17 00:00:00 2001
From: Vincent Sanders <vince@kyllikki.org>
Date: Sat, 8 Nov 2014 11:38:20 +0000
Subject: Fix several doxygen issues

---
 riscos/hotlist.c | 11 ++++++-----
 riscos/mouse.c   |  4 ++--
 riscos/save.c    |  4 ++--
 riscos/sslcert.c | 14 ++++++--------
 4 files changed, 16 insertions(+), 17 deletions(-)

(limited to 'riscos')

diff --git a/riscos/hotlist.c b/riscos/hotlist.c
index 736f368dd..00f9196cd 100644
--- a/riscos/hotlist.c
+++ b/riscos/hotlist.c
@@ -323,11 +323,12 @@ void ro_gui_hotlist_toolbar_save_buttons(char *config)
 /**
  * Prepare the hotlist menu for opening
  *
- * \param  window		The window owning the menu.
- * \param  *menu		The menu about to be opened.
- * \param  *pointer		Pointer to the relevant wimp event block, or
- *				NULL for an Adjust click.
- * \return			true if the event was handled; else false.
+ * \param w       The window owning the menu.
+ * \param i       A wimp icon
+ * \param menu    The menu about to be opened.
+ * \param pointer Pointer to the relevant wimp event block, or
+ *                      NULL for an Adjust click.
+ * \return true if the event was handled; else false.
  */
 
 bool ro_gui_hotlist_menu_prepare(wimp_w w, wimp_i i, wimp_menu *menu,
diff --git a/riscos/mouse.c b/riscos/mouse.c
index e934c1cf4..92b65add3 100644
--- a/riscos/mouse.c
+++ b/riscos/mouse.c
@@ -16,8 +16,8 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-/** \file mouse.c
- * Mouse dragging and tracking support (implementation).
+/** \file
+ * Mouse dragging and tracking support implementation.
  *
  * Two different functions are provided:-
  *
diff --git a/riscos/save.c b/riscos/save.c
index a45cd1248..de0046ff0 100644
--- a/riscos/save.c
+++ b/riscos/save.c
@@ -405,8 +405,8 @@ void gui_drag_save_object(struct gui_window *g, hlcache_handle *c,
 /**
  * Initiates drag saving of a selection from a browser window
  *
- * \param  s  selection object
- * \param  g  gui window
+ * \param g gui window
+ * \param selection selection object
  */
 
 void gui_drag_save_selection(struct gui_window *g, const char *selection)
diff --git a/riscos/sslcert.c b/riscos/sslcert.c
index 9de49f097..3ebf6b788 100644
--- a/riscos/sslcert.c
+++ b/riscos/sslcert.c
@@ -99,15 +99,13 @@ void ro_gui_cert_postinitialise(void)
 }
 
 /**
- * Open the certificate verification dialog
+ * Prompt the user to verify a certificate with issuse.
  *
- * \param  *bw			The browser window owning the certificates.
- * \param  *c			The content data corresponding to the
- *				certificates.
- * \param  *certs		The certificate details.
- * \param  num			The number of certificates included.
+ * \param url The URL being verified.
+ * \param certs The certificate to be verified
+ * \param num The number of certificates to be verified.
+ * \param cb Callback upon user decision.
  */
-
 void gui_cert_verify(nsurl *url,
 		const struct ssl_cert_info *certs, unsigned long num,
 		nserror (*cb)(bool proceed, void *pw), void *cbpw)
@@ -290,7 +288,7 @@ void ro_gui_cert_accept(wimp_pointer *pointer)
 /**
  * Handle rejection of certificate via event callback.
  *
- * \param  w		The wimp pointer block.
+ * \param pointer The wimp pointer block.
  */
 
 void ro_gui_cert_reject(wimp_pointer *pointer)
-- 
cgit v1.2.3