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.