diff --git a/core/modules/comment/comment.module b/core/modules/comment/comment.module
index 4a93850..1924ea4 100644
--- a/core/modules/comment/comment.module
+++ b/core/modules/comment/comment.module
@@ -1084,6 +1084,9 @@ function comment_load($cid, $reset = FALSE) {
  *
  * @return int|false
  *   The number of new comments or FALSE if the user is not logged in.
+ *
+ * @deprecated Deprecated since Drupal 8.x-dev, to be removed in Drupal 8.0.
+ *   Use \Drupal\comment\CommentManager::getCountNewComments().
  */
 function comment_num_new($entity_id, $entity_type, $field_name = NULL, $timestamp = 0) {
   $entity = entity_load($entity_type, $entity_id);