From 8f64d5d223a6ccc60f04e815355c9d3f216a4410 Mon Sep 17 00:00:00 2001
From: Vincent Sanders <vince@kyllikki.org>
Date: Sat, 8 Nov 2014 12:35:11 +0000
Subject: Improve Doxygen documentation

---
 render/search.h | 31 ++++++++++++++++---------------
 1 file changed, 16 insertions(+), 15 deletions(-)

(limited to 'render/search.h')

diff --git a/render/search.h b/render/search.h
index a8354e77e..79d1ee3d3 100644
--- a/render/search.h
+++ b/render/search.h
@@ -29,13 +29,12 @@ struct search_context;
 /**
  * create a search_context
  *
- * \param c 	the content the search_context is connected to
- * \param type	the content type of c
- * \param callbacks the callbacks to modify appearance according to results
- * \param p 	the pointer to send to the callbacks
- * \return true for success
+ * \param c       The content the search_context is connected to
+ * \param type    The content type of c
+ * \param context A context pointer passed to the provider routines.
+ * \return A new search context or NULL on error.
  */
-struct search_context * search_create_context(struct content *c,
+struct search_context *search_create_context(struct content *c,
 				      content_type type, void *context);
 
 /**
@@ -46,11 +45,12 @@ void search_destroy_context(struct search_context *context);
 
 /**
  * Begins/continues the search process
- * Note that this may be called many times for a single search.
  *
- * \param bw the browser_window to search in
- * \param flags the flags forward/back etc
- * \param string the string to match
+ * \note that this may be called many times for a single search.
+ *
+ * \param context The search context in use.
+ * \param flags   The flags forward/back etc
+ * \param string  The string to match
  */
 void search_step(struct search_context *context, search_flags_t flags,
 		const char * string);
@@ -65,11 +65,12 @@ void search_show_all(bool all, struct search_context *context);
  * Determines whether any portion of the given text box should be
  * selected because it matches the current search string.
  *
- * \param  bw            browser window
- * \param  start_offset  byte offset within text of string to be checked
- * \param  end_offset    byte offset within text
- * \param  start_idx     byte offset within string of highlight start
- * \param  end_idx       byte offset of highlight end
+ * \param c            The content to hilight within.
+ * \param start_offset byte offset within text of string to be checked
+ * \param end_offset   byte offset within text
+ * \param start_idx    byte offset within string of highlight start
+ * \param end_idx      byte offset of highlight end
+ * \param context      The search context to hilight entries from.
  * \return true iff part of the box should be highlighted
  */
 bool search_term_highlighted(struct content *c,
-- 
cgit v1.2.3