From 87a53c3e8208558e55b788ee0a7bd7a2fe9abf10 Mon Sep 17 00:00:00 2001 From: Vincent Sanders Date: Sun, 9 Nov 2014 15:48:38 +0000 Subject: [PATCH] Doxygen cleanups and increase DOT_GRAPH_MAX_NODES for some headers --- Docs/Doxyfile | 2 +- desktop/browser_history.c | 34 ++++++++++++++++++++-------------- 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 . */ -/** \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,