     // -----------------------------------------------------------------------------------------------------------------
     // MARK:  Schema Introspection
     
+    /// The database schema. If the database is closed, or some other error occurs, an empty Schema object is returned.
     public var schema: Schema {
         var schemaEntries = [SchemaEntry]()
         

// =====================================================================================================================
// MARK:- Schema

public class Schema : NSObject {
    
    public convenience override init() {

    // -----------------------------------------------------------------------------------------------------------------
    // MARK:  CREATE TABLE
    
    /// Creates a table. This is a helper for executing a CREATE TABLE statement.
    ///
    /// :param: tableName   The name of the table.
    /// :param: definitions Column and constraint definitions. For example, "name TEXT NOT NULL".
    /// :param: ifNotExists If `true`, don't create the table if it already exists. If `false`, then this method will
    ///                     return an error if the table exists already. Defaults to false.
    /// :param: error       An error pointer.
    ///
    /// :returns: true if the table was created, false if an error occurs.
    ///
    public func createTable(tableName:String,
                            definitions:[String],
                            ifNotExists:Bool = false,
