summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorVincent Sanders <vince@kyllikki.org>2014-11-09 15:48:38 +0000
committerVincent Sanders <vince@kyllikki.org>2014-11-09 15:48:38 +0000
commit87a53c3e8208558e55b788ee0a7bd7a2fe9abf10 (patch)
treeac8309f0f96319351ca858032474d30354b30bcc
parente32a2ad46e76438a53fb1157e90215493a93d2f5 (diff)
downloadnetsurf-87a53c3e8208558e55b788ee0a7bd7a2fe9abf10.tar.gz
netsurf-87a53c3e8208558e55b788ee0a7bd7a2fe9abf10.tar.bz2
Doxygen cleanups and increase DOT_GRAPH_MAX_NODES for some headers
-rw-r--r--Docs/Doxyfile2
-rw-r--r--desktop/browser_history.c34
2 files changed, 21 insertions, 15 deletions
diff --git a/Docs/Doxyfile b/Docs/Doxyfile
index 0ed27b25e..72f24dcc8 100644
--- a/Docs/Doxyfile
+++ b/Docs/Doxyfile
@@ -1783,7 +1783,7 @@ MSCFILE_DIRS =
# DOT_GRAPH_MAX_NODES then the graph will not be shown at all. Also note
# that the size of a graph can be further restricted by MAX_DOT_GRAPH_DEPTH.
-DOT_GRAPH_MAX_NODES = 100
+DOT_GRAPH_MAX_NODES = 150
# The MAX_DOT_GRAPH_DEPTH tag can be used to set the maximum depth of the
# graphs generated by dot. A depth value of 3 means that only nodes reachable
diff --git a/desktop/browser_history.c b/desktop/browser_history.c
index fe6121d8e..fb76097ed 100644
--- a/desktop/browser_history.c
+++ b/desktop/browser_history.c
@@ -17,7 +17,8 @@
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
-/** \file
+/**
+ * \file
* Browser history tree implementation.
*/
@@ -84,15 +85,13 @@ struct history {
/**
* Clone a history entry
*
- * \param history opaque history structure, as returned by history_create()
- * \param start entry to clone
- *
- * \return a cloned history entry, or 0 on error
+ * \param history opaque history structure, as returned by history_create()
+ * \param entry entry to clone
+ * \return A cloned history entry or NULL on error
*/
-
-static struct history_entry *browser_window_history__clone_entry(
- struct history *history,
- struct history_entry *entry)
+static struct history_entry *
+browser_window_history__clone_entry(struct history *history,
+ struct history_entry *entry)
{
struct history_entry *child;
struct history_entry *new_child;
@@ -241,12 +240,19 @@ static void browser_window_history__layout(struct history *history)
/**
* Recursively redraw a history_entry.
*
- * \param history history containing the entry
- * \param history_entry entry to render
- * \param ctx current redraw context
+ * \param history history containing the entry
+ * \param entry entry to render
+ * \param x0 area top left x coordinate
+ * \param y0 area top left y coordinate
+ * \param x1 area bottom right x coordinate
+ * \param y1 area bottom right y coordinate
+ * \param x window x offset
+ * \param y window y offset
+ * \param clip clip redraw
+ * \param ctx current redraw context
*/
-
-static bool browser_window_history__redraw_entry(struct history *history,
+static bool
+browser_window_history__redraw_entry(struct history *history,
struct history_entry *entry,
int x0, int y0, int x1, int y1,
int x, int y, bool clip,