[Checkins] SVN: z3c.sqlalchemy/trunk/src/z3c/sqlalchemy/mapper.py updated docs

[Andreas Jung]

Log message for revision 75716:
  updated docs
  

Changed:
  U   z3c.sqlalchemy/trunk/src/z3c/sqlalchemy/mapper.py

-=-
Modified: z3c.sqlalchemy/trunk/src/z3c/sqlalchemy/mapper.py
===================================================================
--- z3c.sqlalchemy/trunk/src/z3c/sqlalchemy/mapper.py	2007-05-13 14:19:44 UTC (rev 75715)
+++ z3c.sqlalchemy/trunk/src/z3c/sqlalchemy/mapper.py	2007-05-13 14:26:08 UTC (rev 75716)
@@ -49,7 +49,14 @@
 
 
     def getMapper(self, name):
-        """ return a mapper associated with the current mapper """
+        """ Return a mapper associated with the current mapper.
+            If this mapper represents a table A having a relationship
+            to table B then the mapper for B can be obtained through
+            self.getMapper('B'). This method is useful if you don't want
+            to pass the wrapper around this the wrapper is officially
+            the only way to get hold of a mapper by name. See also
+            http://groups.google.com/group/sqlalchemy/browse_thread/thread/%2018fb2e2818bdc032/5c2dfd71679925cb#5c2dfd71679925cb
+        """
         return class_mapper(self.__class__).props[name].mapper.class_