From 781f83f6487aaa4d335c6d61f26055d842426055 Mon Sep 17 00:00:00 2001
From: Benjamin Eberlei <kontakt@beberlei.de>
Date: Sun, 29 Jan 2012 20:45:17 +0100
Subject: [PATCH] Update unitofwork section

---
 en/_theme                   |  2 +-
 en/reference/unitofwork.rst | 66 +++++++++++++++++++++++++++++++++++++
 2 files changed, 67 insertions(+), 1 deletion(-)

diff --git a/en/_theme b/en/_theme
index 65a4cd407..1ce5c0ebd 160000
--- a/en/_theme
+++ b/en/_theme
@@ -1 +1 @@
-Subproject commit 65a4cd4073a46176dfefe031d75724b0e4d80269
+Subproject commit 1ce5c0ebd6ed7e05a083d85bce8be34badaf12db
diff --git a/en/reference/unitofwork.rst b/en/reference/unitofwork.rst
index 856f30a6e..abe7543e7 100644
--- a/en/reference/unitofwork.rst
+++ b/en/reference/unitofwork.rst
@@ -133,3 +133,69 @@ optimize the performance of the Flush Operation:
 - Use :doc:`Change Tracking Policies <change-tracking-policies>` to use more
   explicit strategies of notifying the UnitOfWork what objects/properties
   changed.
+
+
+Query Internals
+---------------
+
+The different ORM Layers
+------------------------
+
+Doctrine ships with a set of layers with different responsibilities. This
+section gives a short explanation of each layer.
+
+Hydration
+~~~~~~~~~
+
+Responsible for creating a final result from a raw database statement and a
+result-set mapping object. The developer can choose which kind of result he
+wishes to be hydrated. Default result-types include:
+
+- SQL to Entities
+- SQL to structured Arrays
+- SQL to simple scalar result arrays
+- SQL to a single result variable
+
+Hydration to entities and arrays is one of most complex parts of Doctrine
+algorithm-wise. It can built results with for example:
+
+- Single table selects
+- Joins with n:1 or 1:n cardinality, grouping belonging to the same parent.
+- Mixed results of objects and scalar values
+- Hydration of results by a given scalar value as key.
+
+Persisters
+~~~~~~~~~~
+
+tbr
+
+UnitOfWork
+~~~~~~~~~~
+
+tbr
+
+ResultSetMapping
+~~~~~~~~~~~~~~~~
+
+tbr
+
+DQL Parser
+~~~~~~~~~~
+
+tbr
+
+SQLWalker
+~~~~~~~~~
+
+tbr
+
+EntityManager
+~~~~~~~~~~~~~
+
+tbr
+
+ClassMetadataFactory
+~~~~~~~~~~~~~~~~~~~~
+
+tbr
+