From 148fc615c0cc8558f17b1d894b4ef2e60e5149b7 Mon Sep 17 00:00:00 2001
From: pookey <pookey@625475ce-881a-0410-a577-b389adb331d8>
Date: Thu, 31 May 2007 20:42:35 +0000
Subject: [PATCH] more docs, hopefully my last commit tonight...

---
 manual/docbook/doctrine.xml | 38 +++++++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)

diff --git a/manual/docbook/doctrine.xml b/manual/docbook/doctrine.xml
index b3d4df3e3..249c778bc 100644
--- a/manual/docbook/doctrine.xml
+++ b/manual/docbook/doctrine.xml
@@ -206,6 +206,44 @@
         url="http://www.martinfowler.com/eaaCatalog/activeRecord.html">Active
         Record pattern</ulink>
       </para>
+      <para>
+        Doctrine auto-creates database tables and always adds a primary key
+        column named 'id' to tables that doesn't have any primary keys
+        specified. Only thing you need to for creating database tables is
+        defining a class which extends Doctrine_Record and setting a
+        setTableDefinition method with hasColumn() method calls.
+      </para>
+      <para>
+        An short example:
+      </para>
+      <para>
+        We want to create a database table called 'user' with columns
+        id(primary key), name, username, password and created. Provided that
+        you have already installed Doctrine these few lines of code are all you
+        need:
+      </para>
+      <programlisting role="php"><![CDATA[
+<?php 
+
+    require_once('lib/Doctrine.php');
+
+    spl_autoload_register(array('Doctrine', 'autoload'));
+
+    class User extends Doctrine_Record { 
+        public function setTableDefinition() {
+            // set 'user' table columns, note that
+            // id column is always auto-created
+            
+            $this->hasColumn('name','string',30);
+            $this->hasColumn('username','string',20);
+            $this->hasColumn('password','string',16);
+            $this->hasColumn('created','integer',11);
+        }
+    }
+?>]]></programlisting>
+      <para>
+        We now have a user model that supports basic CRUD opperations!
+      </para>
     </sect1>
   </chapter>