From b9c8bdc69608864b258630dd0a58312f70917d30 Mon Sep 17 00:00:00 2001
From: Silvio <silvio@devlet.com.br>
Date: Tue, 30 Mar 2010 16:47:56 -0300
Subject: Enhancing docs

---
 interface.php | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

(limited to 'interface.php')

diff --git a/interface.php b/interface.php
index f5802d7..c2e1e9b 100644
--- a/interface.php
+++ b/interface.php
@@ -7,15 +7,21 @@ interface IsisDb {
   /**
    * Constructor.
    *
+   * The implementation constructor should accept a database
+   * schema definition and setup the appropriate db resource.
+   *
    * @param $schema
    *   High level database schema description.
    *
+   * @return
+   *   Database resource or FALSE in case of error.
+   *
    * @see default_schema()
    */
   public function __construct($schema);
 
   /**
-   * Read an entry.
+   * Read an entry from the database.
    *
    * @param $id
    *   Database row id.
@@ -33,6 +39,9 @@ interface IsisDb {
   /**
    * Return a default example schema.
    *
+   * The example schema should have all information the implementation
+   * needs to be able to open and read a database.
+   *
    * @return
    *   Array with a sample database schema.
    */
-- 
cgit v1.2.3