core/modules/contextual/contextual.module |   29 +++++++++++++++--------------
 1 file changed, 15 insertions(+), 14 deletions(-)

diff --git a/core/modules/contextual/contextual.module b/core/modules/contextual/contextual.module
index 3513f56..7da43e0 100644
--- a/core/modules/contextual/contextual.module
+++ b/core/modules/contextual/contextual.module
@@ -154,10 +154,10 @@ function contextual_preprocess(&$variables, $hook, $info) {
  * contains an identifier ("contextual id"), which allows the JavaScript of the
  * drupal.contextual-links library to dynamically render contextual links.
  *
- * @param $element
+ * @param array $element
  *   A structured array with #id containing a "contextual id".
  *
- * @return
+ * @return html
  *   The passed-in element with a contextual link placeholder in '#markup'.
  *
  * @see _contextual_links_to_id()
@@ -171,7 +171,7 @@ function contextual_pre_render_placeholder($element) {
 /**
  * Pre-render callback: Builds a renderable array for contextual links.
  *
- * @param $element
+ * @param array $element
  *   A renderable array containing a #contextual_links property, which is a
  *   keyed array. Each key is the name of the group of contextual links to
  *   render (based on the 'group' key in the *.contextual_links.yml files for
@@ -179,18 +179,19 @@ function contextual_pre_render_placeholder($element) {
  *   the following keys:
  *   - route_parameters: The route parameters passed to the url generator.
  *   - metadata: Any additional data needed in order to alter the link.
- *   @code
- *     array('#contextual_links' => array(
- *       'block' => array(
- *         'route_parameters' => array('block' => 'system.menu-tools'),
- *       ),
- *       'menu' => array(
- *         'route_parameters' => array('menu' => 'tools'),
- *       ),
- *     ))
- *   @endcode
  *
- * @return
+ * @code
+ *   array('#contextual_links' => array(
+ *     'block' => array(
+ *       'route_parameters' => array('block' => 'system.menu-tools'),
+ *     ),
+ *     'menu' => array(
+ *       'route_parameters' => array('menu' => 'tools'),
+ *     ),
+ *   ))
+ * @endcode
+ *
+ * @return array
  *   A renderable array representing contextual links.
  *
  * @see contextual_element_info()