X-Git-Url: https://git.liburcu.org/?a=blobdiff_plain;f=urcu%2Fwfstack.h;h=20d1882c867b979910ad6000b8c3b64a8879a0c7;hb=d05e9936ac167ead3a0ff5ca8ad0ade762bcda18;hp=aa10881506a5ad2609cb62a39b18ee916e1676d2;hpb=a03a0f42bd1e3ca7c0cb207d9d5b19c61e696068;p=urcu.git

diff --git a/urcu/wfstack.h b/urcu/wfstack.h
index aa10881..20d1882 100644
--- a/urcu/wfstack.h
+++ b/urcu/wfstack.h
@@ -162,6 +162,8 @@ extern struct cds_wfs_head *cds_wfs_pop_all_blocking(struct cds_wfs_stack *s);
  * Used by for-like iteration macros in urcu/wfstack.h:
  * cds_wfs_for_each_blocking()
  * cds_wfs_for_each_blocking_safe()
+ *
+ * Returns NULL if popped stack is empty, top stack node otherwise.
  */
 extern struct cds_wfs_node *cds_wfs_first_blocking(struct cds_wfs_head *head);
 
@@ -174,6 +176,9 @@ extern struct cds_wfs_node *cds_wfs_first_blocking(struct cds_wfs_head *head);
  * Used by for-like iteration macros in urcu/wfstack.h:
  * cds_wfs_for_each_blocking()
  * cds_wfs_for_each_blocking_safe()
+ *
+ * Returns NULL if reached end of popped stack, non-NULL next stack
+ * node otherwise.
  */
 extern struct cds_wfs_node *cds_wfs_next_blocking(struct cds_wfs_node *node);