diff --git a/core/core.api.php b/core/core.api.php
index 9f2f7f7ece..6749b21a9a 100755
--- a/core/core.api.php
+++ b/core/core.api.php
@@ -607,7 +607,8 @@
  * @endcode
  *
  * For cache bins that are stored in the database, the number of rows is limited
- * to 5000 by default. This can be changed for all database cache bins:
+ * to 5000 by default. This can be changed for all database cache bins. For
+ * example to instead limit the number of rows to 50,000:
  * @code
  * $settings['database_cache_max_rows']['default'] = 50000;
  * @endcode