[Zope3-checkins] CVS: Zope/lib/python/ZODB - Connection.py:1.126

[Jeremy Hylton]

Update of /cvs-repository/Zope/lib/python/ZODB
In directory cvs.zope.org:/tmp/cvs-serv18242

Modified Files:
	Connection.py 
Log Message:
Add two notes about common use.


=== Zope/lib/python/ZODB/Connection.py 1.125 => 1.126 ===
--- Zope/lib/python/ZODB/Connection.py:1.125	Thu Feb 26 17:55:51 2004
+++ Zope/lib/python/ZODB/Connection.py	Thu Feb 26 17:57:09 2004
@@ -76,6 +76,9 @@
 
     You should not instantiate this class directly; instead call the
     open() method of a DB instance.
+
+    In many applications, root() is the only method of the Connection
+    that you will need to use.
     
     Synchronization
 
@@ -221,6 +224,9 @@
         ghostable, then a ghost will be returned.  If the object is
         already in the cache, a reference to the cached object will be
         returned.
+
+        Applications seldom need to call this method, because objects
+        are loaded transparently during attribute lookup.
 
         @return: persistent object
         @rtype: L{IPersistent}