diff --git a/lib/Cake/View/Helper/HtmlHelper.php b/lib/Cake/View/Helper/HtmlHelper.php
index 7a1943aae..626e7cb32 100644
--- a/lib/Cake/View/Helper/HtmlHelper.php
+++ b/lib/Cake/View/Helper/HtmlHelper.php
@@ -738,12 +738,11 @@ class HtmlHelper extends AppHelper {
}
/**
- * Creates a formatted IMG element. If `$options['url']` is provided, an image link will be
- * generated with the link pointed at `$options['url']`. If `$options['fullBase']` is provided,
- * the src attribute will receive full address (non-relative url) of the image file.
+ * Creates a formatted IMG element.
+ *
* This method will set an empty alt attribute if one is not supplied.
*
- * ### Usage
+ * ### Usage:
*
* Create a regular image:
*
@@ -753,8 +752,15 @@ class HtmlHelper extends AppHelper {
*
* `echo $html->image('cake_icon.png', array('alt' => 'CakePHP', 'url' => 'http://cakephp.org'));`
*
+ * ### Options:
+ *
+ * - `url` If provided an image link will be generated and the link will point at
+ * `$options['url']`.
+ * - `fullBase` If provided the src attribute will get a full addres (non-relative url) for
+ * the image file.
+ *
* @param string $path Path to the image file, relative to the app/webroot/img/ directory.
- * @param array $options Array of HTML attributes.
+ * @param array $options Array of HTML attributes. See above for special options.
* @return string completed img tag
* @link http://book.cakephp.org/2.0/en/core-libraries/helpers/html.html#HtmlHelper::image
*/