diff --git a/doc/man/man1/clush.1 b/doc/man/man1/clush.1
index d5836c5..f65be4b 100644
--- a/doc/man/man1/clush.1
+++ b/doc/man/man1/clush.1
@@ -124,6 +124,9 @@ execute COMMAND on the local system
 .TP
 .B clush> =
 toggle the output format (gathered or standard mode)
+.TP
+.B clush> *
+broadcast the next command to every configured node
 .UNINDENT
 .UNINDENT
 .sp
diff --git a/doc/sphinx/guide/nodesets.rst b/doc/sphinx/guide/nodesets.rst
index 983a00b..e20e772 100644
--- a/doc/sphinx/guide/nodesets.rst
+++ b/doc/sphinx/guide/nodesets.rst
@@ -54,6 +54,13 @@ a basic usage of the :class:`.NodeSet` class::
     >>> print(NodeSet.fromlist(["clu-1-[1-4]", "clu-2-[1-4]"]))
     clu-[1-2]-[1-4]
 
+You can also iterate over the nodes one at a time::
+
+    >>> nodeset = NodeSet("node[1-3]")
+    >>> it = iter(nodeset)
+    >>> print it.next()
+    node1
+
 All corresponding Python sets operations are available, for example::
 
     >>> from ClusterShell.NodeSet import NodeSet