summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBrant Thomsen <brant.thomsen@harman.com>2017-07-14 16:05:31 -0600
committerBrant Thomsen <brant.thomsen@harman.com>2017-07-14 16:05:31 -0600
commit7ce324d6c05057710f4db3f6bb989537c066275a (patch)
treeb5d26445107a215624030167aabb73e7e91c65a7
parent967fd6a84d0e8025f4eb5155a7af51b04cb153d8 (diff)
downloadOpen-AVB-7ce324d6c05057710f4db3f6bb989537c066275a.tar.gz
openavb_list comment cleanup
Added more details to the description comments for openavbListAdd() and openavbListNew(). Clarified that several functions will return NULL rather than FALSE.
-rw-r--r--lib/avtp_pipeline/util/openavb_list.h20
1 files changed, 10 insertions, 10 deletions
diff --git a/lib/avtp_pipeline/util/openavb_list.h b/lib/avtp_pipeline/util/openavb_list.h
index e1c2af15..15826464 100644
--- a/lib/avtp_pipeline/util/openavb_list.h
+++ b/lib/avtp_pipeline/util/openavb_list.h
@@ -49,37 +49,37 @@ openavb_list_t openavbListNewList(void);
// Delete a link list.
void openavbListDeleteList(openavb_list_t list);
-// Add a data element as a node to a link list. Returns NULL on failure.
+// Add a data element as a node to the end (tail) of a link list. Returns NULL on failure.
openavb_list_node_t openavbListAdd(openavb_list_t list, void *data);
-// Allocate and manage data element and add as a node to a link list. Returns NULL on failure.
+// Allocate and manage data element and add as a node to the end (tail) of a link list. Returns NULL on failure.
openavb_list_node_t openavbListNew(openavb_list_t list, U32 size);
// Remove (delete) node. Returns NULL on failure otherwise next node.
openavb_list_node_t openavbListDelete(openavb_list_t list, openavb_list_node_t node);
-// Gets the next node. Returns FALSE on error or if already at the tail.
+// Gets the next node. Returns NULL on error or if already at the tail.
openavb_list_node_t openavbListNext(openavb_list_t list, openavb_list_node_t node);
-// Gets the previous node. Returns FALSE on error or if already at the head.
+// Gets the previous node. Returns NULL on error or if already at the head.
openavb_list_node_t openavbListPrev(openavb_list_t list, openavb_list_node_t node);
-// Gets the first (head) node. Returns FALSE on error or empty list.
+// Gets the first (head) node. Returns NULL on error or empty list.
openavb_list_node_t openavbListFirst(openavb_list_t list);
-// Gets the lastt (tail) node. Returns FALSE on error or empty list.
+// Gets the last (tail) node. Returns NULL on error or empty list.
openavb_list_node_t openavbListLast(openavb_list_t list);
-// Gets the first node and preps for iteration. Returns FALSE on error or empty list.
+// Gets the first node and preps for iteration. Returns NULL on error or empty list.
openavb_list_node_t openavbListIterFirst(openavb_list_t list);
-// Gets the last node and preps for iteration. Returns FALSE on error or empty list.
+// Gets the last node and preps for iteration. Returns NULL on error or empty list.
openavb_list_node_t openavbListIterLast(openavb_list_t list);
-// Gets the next node in the iteration. Returns FALSE on error or end of list.
+// Gets the next node in the iteration. Returns NULL on error or end of list.
openavb_list_node_t openavbListIterNext(openavb_list_t list);
-// Gets the prev node in the iteration. Returns FALSE on error or beginning of list.
+// Gets the previous node in the iteration. Returns NULL on error or beginning of list.
openavb_list_node_t openavbListIterPrev(openavb_list_t list);
// Get data element. Returns NULL on failure.