diff --git a/core/modules/aggregator/aggregator.pages.inc b/core/modules/aggregator/aggregator.pages.inc
index 2a1e2e3..c141b8c 100644
--- a/core/modules/aggregator/aggregator.pages.inc
+++ b/core/modules/aggregator/aggregator.pages.inc
@@ -105,8 +105,10 @@ function aggregator_page_category_form($form, $form_state, $category) {
  * @param int $limit
  *   (optional) The number of records to return. Defaults to 20.
  *
- * @deprecated Use \Drupal\aggregator\ItemStorageController::loadFeedItems()
- *   instead.
+ * @deprecated Use \Drupal\aggregator\ItemStorageController::loadFeedItems() for
+ *   loading all feed items, \Drupal\aggregator\ItemStorageController::loadFeedItemsBySource()
+ *   for loading feed items filtered by the source feed, and \Drupal\aggregator\ItemStorageController::loadFeedItemsByCategory()
+ *   for loading feed items filtered by the feed category.
  *
  * @return \Drupal\aggregator\ItemInterface[]
  *   An array of the feed items.