diff --git a/manual/docbook/intro.xml b/manual/docbook/intro.xml index aac99d53b..6512a3f65 100644 --- a/manual/docbook/intro.xml +++ b/manual/docbook/intro.xml @@ -271,9 +271,9 @@ for whatever reason, see below for details on downloading a snapshot. - bash $mkdir doctrine - bash $cd doctrine - bash $svn checkout http://doctrine.pengus.net/svn/trunk . + bash $ mkdir doctrine + bash $ cd doctrine + bash $ svn checkout http://doctrine.pengus.net/svn/trunk . Daily snapshots can be found at @@ -286,22 +286,24 @@ Include and autoload - In order to use Doctrine in your project it must first be included. + In order to use Doctrine in your project, you must first include the main + library file called 'Doctrine.php'. ]]> - Doctrine support Autoloading for including - files so that you do not have to include anything more then the base - file. There are two different strategies that can be used to do this: + files so that you don't have to include anything more then the base + file. There are two different strategies that can be used to do this, + as shown below. - If you do use the __autoload function for your own - logic you can use it. + You can use the __autoload function to call the + 'Doctrine::autoload($class)' method, for example: ]]> - If your project uses autoload and/or you have other libraries that use - it you could use spl_autoload_register - to register more then one autoloading function. + to register multiple autoloading functions. Compiling - Compiling is a method for making a single file of most used doctrine - runtime components including the compiled file instead of multiple files + Compiling is a method for making a single file of the most used doctrine + runtime components. Including this compiled file instead of multiple files (in worst cases dozens of files) can improve performance by an order of magnitude. - In cases where this might fail, a Doctrine_Exception is throw detailing + In cases where this might fail, a Doctrine_Exception is thrown detailing the error. Doctrine auto-creates database tables and always adds a primary key - column named 'id' to tables that doesn't have any primary keys + column named 'id' to tables that don't have any primary keys specified. The only thing you need to do to create database tables is defining a class which extends Doctrine_Record and setting a setTableDefinition method with hasColumn() method calls.