diff --git a/core/includes/bootstrap.inc b/core/includes/bootstrap.inc
index e04f033..aed238c 100644
--- a/core/includes/bootstrap.inc
+++ b/core/includes/bootstrap.inc
@@ -949,10 +949,11 @@ function drupal_static_reset($name = NULL) {
  * Formats text for emphasized display in a placeholder inside a sentence.
  *
  * @deprecated in Drupal 8.0.0, will be removed before Drupal 9.0.0. Use
- *   \Drupal\Component\Utility\SafeMarkup::format() and a %variable in
- *   associative array of replacements to make instead. Note this this method
- *   should not be used to only emphasise a string and therefore has few valid
- *   use-cases. Note also, that this method does not mark the string as safe.
+ *   \Drupal\Component\Utility\SafeMarkup::format() with a %variable in an
+ *   associative array of replacements, or the "placeholder" filter in Twig
+ *   templates instead. Note this method should not be used to only emphasise a
+ *   string and therefore has few valid use-cases. Note also, that this method
+ *   does not mark the string as safe.
  *
  * @see \Drupal\Component\Utility\SafeMarkup::format()
  */