diff --git a/core/lib/Drupal/Core/Database/Query/SelectInterface.php b/core/lib/Drupal/Core/Database/Query/SelectInterface.php
index 248c4aaf89b20505291f17ad18da4be4d4b2ef1a..aa358d3c29f4dace167fc3b70f7822a6cbfe331f 100644
--- a/core/lib/Drupal/Core/Database/Query/SelectInterface.php
+++ b/core/lib/Drupal/Core/Database/Query/SelectInterface.php
@@ -340,6 +340,12 @@ public function leftJoin($table, $alias = NULL, $condition = NULL, $arguments =
    *   An array of arguments to replace into the $condition of this join.
    * @return
    *   The unique alias that was assigned for this table.
+   *
+   * @deprecated as of Drupal 8.1.x, will be removed in Drupal 9.0.0. Instead,
+   *   change the query to use leftJoin(). For instance:
+   *   db_query('A')->rightJoin('B') is identical to
+   *   db_query('B')->leftJoin('A'). This functionality has been deprecated
+   *   because SQLite does not support it.
    */
   public function rightJoin($table, $alias = NULL, $condition = NULL, $arguments = array());