Enhance cursor start:/initial: doc

lib/flor/pcore/cursor.rb

@@ -62,6 +62,10 @@ class Flor::Pro::Cursor < Flor::Procedure
   #
   # ## cursor and start: / initial: attribute
   #
+  # Sometimes, it is necessary to enter a cursor not at its first child, but
+  # its second or third. Once such a cursor is entered and a `continue` is
+  # met it will "rewind" to the first child (not the "start" child).
+  #
   # ```
   # task 'create mandate'
   # cursor start: 'approve mandate'
@@ -71,6 +75,15 @@ class Flor::Pro::Cursor < Flor::Procedure
   # task 'activate mandate'
   # ```
   #
+  # The string passed to start:/initial: is looked up (down) in the cursor
+  # in the order: (example `cursor start: 'bravo'`)
+  #
+  # * tag (for example `push l 'b' tag: 'bravo'`)
+  # * string argument (for example `task 'toto' context: 'bravo'`)
+  # * string target (for example `task 'bravo'`)
+  # * name target (for example `bravo _`)
+  # * att target (for example `task 'toto' bravo: 'ok'`)
+  #
   # ## see also
   #
   # Break, continue, loop.