added references and merged comments

Author: phiamo

bundles/block/types.rst

@@ -136,17 +136,18 @@ block mapped by the persistence layer as argument. If you set this to
 something that is not a valid block, the problem is only detected when
 rendering the block.
 
+.. _bundles-block-menu:
+
 MenuBlock
 ---------
 
-This block has no content of its own, but points to a target menu.
-When rendered, this block renders the target menu just as if the target
-menu was directly used in that place.
+This block has no content of its own, but points to a target menu or
+menu entry. When rendered, this block renders the target menu just as
+if the target menu was directly used in that place. If pointing to a
+menu entry, the menu gets rendered from this point.
 
-This block simply has the method ``setReferencedMenu`` that accepts any
-menu mapped by the persistence layer as argument. If you set this to
-something that is not a valid menu, the problem is only detected when
-rendering the block.
+This block simply has the method ``setMenuNode`` that accepts any
+menu mapped by the persistence layer as argument.
 
 ActionBlock
 -----------

bundles/menu/introduction.rst

@@ -131,18 +131,10 @@ example is specified. This will render an unordered list as follows:
 
 .. tip::
 
-    You can reference menus in the`symfony-cmf/block-bundle`_ and render 
-    them in any places where you are using a Block:
-    
-    .. configuration-block::
-
-        .. code-block:: jinja
-        
-            {{ sonate_render_block('/cms/some/path/my-referencing-menu-block') }}
-
-        .. code-block:: php
+    When using the :doc:`BlockBundle <../block/introduction>`, you can also use the
+    ``MenuBlock``. Read more about that in the
+    :ref:`BlockBundle documentation <bundles-block-menu>`
 
-            echo $view['sonata_block']->render('/cms/some/path/my-referencing-menu-block');
 .. note::
 
      It is the ``PhpcrMenuProvider`` class which allows us to specify a