diff --git a/core/includes/bootstrap.inc b/core/includes/bootstrap.inc
index 5472321..ddb197a 100644
--- a/core/includes/bootstrap.inc
+++ b/core/includes/bootstrap.inc
@@ -1705,6 +1705,10 @@ function drupal_get_title() {
  *   from $title using a function like check_plain() or filter_xss(). With this
  *   flag the string will be passed through unchanged.
  *
+ * @deprecated This will be removed in 8.0. Instead set the #title property on
+ *   the resulting render array of your controller. If you need to change the
+ *   title, set it to the '_title' attribute on the request object.
+ *
  * @return
  *   The updated title of the current page.
  */