Clean up rb documentation.

This commit is contained in:
Jason Evans 2011-11-01 20:48:31 -07:00
parent c67e4fdc71
commit da9dde0854

View File

@ -223,78 +223,78 @@ a_prefix##reverse_iter(a_rbt_type *rbtree, a_type *start, \
* The following API is generated: * The following API is generated:
* *
* static void * static void
* ex_new(ex_t *extree); * ex_new(ex_t *tree);
* Description: Initialize a red-black tree structure. * Description: Initialize a red-black tree structure.
* Args: * Args:
* extree: Pointer to an uninitialized red-black tree object. * tree: Pointer to an uninitialized red-black tree object.
* *
* static ex_node_t * * static ex_node_t *
* ex_first(ex_t *extree); * ex_first(ex_t *tree);
* static ex_node_t * * static ex_node_t *
* ex_last(ex_t *extree); * ex_last(ex_t *tree);
* Description: Get the first/last node in extree. * Description: Get the first/last node in tree.
* Args: * Args:
* extree: Pointer to an initialized red-black tree object. * tree: Pointer to an initialized red-black tree object.
* Ret: First/last node in extree, or NULL if extree is empty. * Ret: First/last node in tree, or NULL if tree is empty.
* *
* static ex_node_t * * static ex_node_t *
* ex_next(ex_t *extree, ex_node_t *node); * ex_next(ex_t *tree, ex_node_t *node);
* static ex_node_t * * static ex_node_t *
* ex_prev(ex_t *extree, ex_node_t *node); * ex_prev(ex_t *tree, ex_node_t *node);
* Description: Get node's successor/predecessor. * Description: Get node's successor/predecessor.
* Args: * Args:
* extree: Pointer to an initialized red-black tree object. * tree: Pointer to an initialized red-black tree object.
* node : A node in extree. * node: A node in tree.
* Ret: node's successor/predecessor in extree, or NULL if node is * Ret: node's successor/predecessor in tree, or NULL if node is
* last/first. * last/first.
* *
* static ex_node_t * * static ex_node_t *
* ex_search(ex_t *extree, ex_node_t *key); * ex_search(ex_t *tree, ex_node_t *key);
* Description: Search for node that matches key. * Description: Search for node that matches key.
* Args: * Args:
* extree: Pointer to an initialized red-black tree object. * tree: Pointer to an initialized red-black tree object.
* key : Search key. * key : Search key.
* Ret: Node in extree that matches key, or NULL if no match. * Ret: Node in tree that matches key, or NULL if no match.
* *
* static ex_node_t * * static ex_node_t *
* ex_nsearch(ex_t *extree, ex_node_t *key); * ex_nsearch(ex_t *tree, ex_node_t *key);
* static ex_node_t * * static ex_node_t *
* ex_psearch(ex_t *extree, ex_node_t *key); * ex_psearch(ex_t *tree, ex_node_t *key);
* Description: Search for node that matches key. If no match is found, * Description: Search for node that matches key. If no match is found,
* return what would be key's successor/predecessor, were * return what would be key's successor/predecessor, were
* key in extree. * key in tree.
* Args: * Args:
* extree: Pointer to an initialized red-black tree object. * tree: Pointer to an initialized red-black tree object.
* key : Search key. * key : Search key.
* Ret: Node in extree that matches key, or if no match, hypothetical * Ret: Node in tree that matches key, or if no match, hypothetical node's
* node's successor/predecessor (NULL if no successor/predecessor). * successor/predecessor (NULL if no successor/predecessor).
* *
* static void * static void
* ex_insert(ex_t *extree, ex_node_t *node); * ex_insert(ex_t *tree, ex_node_t *node);
* Description: Insert node into extree. * Description: Insert node into tree.
* Args: * Args:
* extree: Pointer to an initialized red-black tree object. * tree: Pointer to an initialized red-black tree object.
* node : Node to be inserted into extree. * node: Node to be inserted into tree.
* *
* static void * static void
* ex_remove(ex_t *extree, ex_node_t *node); * ex_remove(ex_t *tree, ex_node_t *node);
* Description: Remove node from extree. * Description: Remove node from tree.
* Args: * Args:
* extree: Pointer to an initialized red-black tree object. * tree: Pointer to an initialized red-black tree object.
* node : Node in extree to be removed. * node: Node in tree to be removed.
* *
* static ex_node_t * * static ex_node_t *
* ex_iter(ex_t *extree, ex_node_t *start, ex_node_t *(*cb)(ex_t *, * ex_iter(ex_t *tree, ex_node_t *start, ex_node_t *(*cb)(ex_t *,
* ex_node_t *, void *), void *arg); * ex_node_t *, void *), void *arg);
* static ex_node_t * * static ex_node_t *
* ex_reverse_iter(ex_t *extree, ex_node_t *start, ex_node *(*cb)(ex_t *, * ex_reverse_iter(ex_t *tree, ex_node_t *start, ex_node *(*cb)(ex_t *,
* ex_node_t *, void *), void *arg); * ex_node_t *, void *), void *arg);
* Description: Iterate forward/backward over extree, starting at node. * Description: Iterate forward/backward over tree, starting at node. If
* If extree is modified, iteration must be immediately * tree is modified, iteration must be immediately
* terminated by the callback function that causes the * terminated by the callback function that causes the
* modification. * modification.
* Args: * Args:
* extree: Pointer to an initialized red-black tree object. * tree : Pointer to an initialized red-black tree object.
* start: Node at which to start iteration, or NULL to start at * start: Node at which to start iteration, or NULL to start at
* first/last node. * first/last node.
* cb : Callback function, which is called for each node during * cb : Callback function, which is called for each node during
@ -303,7 +303,7 @@ a_prefix##reverse_iter(a_rbt_type *rbtree, a_type *start, \
* callback function returns non-NULL, iteration is immediately * callback function returns non-NULL, iteration is immediately
* terminated and the non-NULL return value is returned by the * terminated and the non-NULL return value is returned by the
* iterator. This is useful for re-starting iteration after * iterator. This is useful for re-starting iteration after
* modifying extree. * modifying tree.
* arg : Opaque pointer passed to cb(). * arg : Opaque pointer passed to cb().
* Ret: NULL if iteration completed, or the non-NULL callback return value * Ret: NULL if iteration completed, or the non-NULL callback return value
* that caused termination of the iteration. * that caused termination of the iteration.