diff --git a/core/includes/database/schema.inc b/core/includes/database/schema.inc
index 27934dcdf0410b87a26af9fc0bc397e1c725d3b5..8905d3cecc83b860ae14d202b72e896fc7c1d088 100644
--- a/core/includes/database/schema.inc
+++ b/core/includes/database/schema.inc
@@ -77,7 +77,8 @@
  *       (decimal digits right of the decimal point). Both values are
  *       mandatory. Ignored for other field types.
  *     All parameters apart from 'type' are optional except that type
- *     'numeric' columns must specify 'precision' and 'scale'.
+ *     'numeric' columns must specify 'precision' and 'scale', and type
+ *     'varchar' must specify the 'length' parameter.
  *  - 'primary key': An array of one or more key column specifiers (see below)
  *    that form the primary key.
  *  - 'unique keys': An associative array of unique keys ('keyname' =>