diff --git a/core/modules/comment/comment.module b/core/modules/comment/comment.module
index 8bcac2cedfd9cf386c99352489280030794dd6a2..b256da67965e55ab77daeefd267829809023c689 100644
--- a/core/modules/comment/comment.module
+++ b/core/modules/comment/comment.module
@@ -257,6 +257,9 @@ function comment_node_view_alter(array &$build, EntityInterface $node, EntityVie
  *
  * @return array
  *   An array as expected by drupal_render().
+ *
+ * @deprecated in Drupal 8.x and will be removed before Drupal 9.0.
+ *   Use \Drupal::entityManager()->getViewBuilder('comment')->view().
  */
 function comment_view(CommentInterface $comment, $view_mode = 'full', $langcode = NULL) {
   return entity_view($comment, $view_mode, $langcode);
@@ -277,6 +280,9 @@ function comment_view(CommentInterface $comment, $view_mode = 'full', $langcode
  * @return array
  *   An array in the format expected by drupal_render().
  *
+ * @deprecated in Drupal 8.x and will be removed before Drupal 9.0.
+ *   Use \Drupal::entityManager()->getViewBuilder('comment')->viewMultiple().
+ *
  * @see drupal_render()
  */
 function comment_view_multiple($comments, $view_mode = 'full', $langcode = NULL) {