update doc

CHANGES.rst

@@ -4,7 +4,9 @@ Change History
 2.9.3 (unreleased)
 ==================
 
-- Add ``--verbose`` and ``--section`` flags to ``annotate`` command.
+- Add more verbosity to ``annotate`` results with ``-v``
+
+- Select one or more sections with arguments after ``buildout annotate``.
 
 
 2.9.2 (2017-03-06)

doc/reference.rst

@@ -118,11 +118,17 @@ where they came from. Try it!
 .. _bootstrap-command:
 
 
-``--verbose``
-  Increase the verbosity of the output: display all steps that compute the final values used by buildout.
+.. code-block:: console
+
+   buildout -v annotate
+
+  Increase the verbosity of the output to display all steps that compute the final values used by buildout.
+
+.. code-block:: console
+
+   buildout annotate versions
   
-``--section section``
-  Only display annotation for the given section.
+  You can pass one or more section names as arguments to display annotation only for the given sections.
 
 bootstrap
 _________