From 45c784d5ca068c8693362350eb9114da023cc0b9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?G=C3=A1bor=20Hojtsy?= Date: Fri, 14 Sep 2007 10:43:26 +0000 Subject: [PATCH] #175524 by bjaspan: document the exisance of the description fields in schema API --- includes/database.inc | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/includes/database.inc b/includes/database.inc index a1c0c8230f7..e5cefded61a 100644 --- a/includes/database.inc +++ b/includes/database.inc @@ -326,13 +326,22 @@ function db_escape_table($string) { * hook_schema() should return an array with a key for each table that * the module defines. * - * The following keys in the table definition are processed during - * table creation: + * The following keys are defined: * + * - 'description': A string describing this table and its purpose. + * References to other tables should be enclosed in + * curly-brackets. For example, the node_revisions table + * description field might contain "Stores per-revision title and + * body data for each {node}." * - 'fields': An associative array ('fieldname' => specification) * that describes the table's database columns. The specification * is also an array. The following specification parameters are defined: * + * - 'description': A string describing this field and its purpose. + * References to other tables should be enclosed in + * curly-brackets. For example, the node table vid field + * description might contain "Always holds the largest (most + * recent) {node_revisions}.vid value for this nid." * - 'type': The generic datatype: 'varchar', 'int', 'serial' * 'float', 'numeric', 'text', 'blob' or 'datetime'. Most types * just map to the according database engine specific