diff --git a/modules/aggregator/aggregator.api.php b/modules/aggregator/aggregator.api.php
index f31413c..c3c9be1 100644
--- a/modules/aggregator/aggregator.api.php
+++ b/modules/aggregator/aggregator.api.php
@@ -85,24 +85,24 @@ function hook_aggregator_fetch_info() {
  *   from $feed->source_string and expose it to other modules as an array of
  *   data items on $feed->items.
  *
- *   Feed format:
- *   - $feed->description (string) - description of the feed
- *   - $feed->image (string) - image for the feed
- *   - $feed->etag (string) - value of feed's entity tag header field
- *   - $feed->modified (UNIX timestamp) - value of feed's last modified header
- *     field
- *   - $feed->items (Array) - array of feed items.
- *
- *   By convention, the common format for a single feed item is:
- *   $item[key-name] = value;
- *
- *   Recognized keys:
- *   TITLE (string) - the title of a feed item
- *   DESCRIPTION (string) - the description (body text) of a feed item
- *   TIMESTAMP (UNIX timestamp) - the feed item's published time as UNIX timestamp
- *   AUTHOR (string) - the feed item's author
- *   GUID (string) - RSS/Atom global unique identifier
- *   LINK (string) - the feed item's URL
+ *   A stdClass object with the following properties:
+ *   - description: The human-readable description of the feed.
+ *   - image: A full <a><img /></a> tag what displays the image of the feed,
+ *     src is an external URL, the link points to the source site. Use l()
+ *     and theme('image') for the rendering.
+ *   - etag: The HTTP header respone field ETag. You can copy from
+ *     $feed->http_headers['etag'].
+ *   - modified: The Unix timestamp when the feed was last modified.
+ *   - items: An array of feed items. The common format for a
+ *     single feed item is an associative array containing:
+ *     - title: The human-readable title of a feed item.
+ *     - description: The human-readable description of the feed item.
+ *     - timestamp: The Unix timestamp when the feed item was last published.
+ *     - author: The name of the author.
+ *     - guid: The RSS/Atom global unique identifier. This field, together
+ *       with link is utilized tobe able to identify already aggregated items.
+ *     - link: The original URL of the feed item. Usually it points
+ *       to a specific path within a website.
  *
  * @return
  *   TRUE if parsing was successful, FALSE otherwise.