[Zodb-checkins] CVS: ZODB3/Doc/zodb - about.html:1.2.6.14
contents.html:1.2.6.14 index.html:1.2.6.14
node2.html:1.2.6.14 node3.html:1.2.6.14 node5.html:1.2.6.14
node6.html:1.2.6.14 node7.html:1.2.6.14 node8.html:1.2.6.14
zeo.html:1.2.6.14 zodb.html:1.2.6.14
Tim Peters
tim.one at comcast.net
Mon Mar 7 17:45:59 EST 2005
Update of /cvs-repository/ZODB3/Doc/zodb
In directory cvs.zope.org:/tmp/cvs-serv7074/Doc/zodb
Modified Files:
Tag: Zope-2_7-branch
about.html contents.html index.html node2.html node3.html
node5.html node6.html node7.html node8.html zeo.html zodb.html
Log Message:
Make the current state look like the 3.2.6 release, in case Andreas
sneaks 2.7.5 out before I can do a ZODB 3.2.6 release for real.
=== ZODB3/Doc/zodb/about.html 1.2.6.13 => 1.2.6.14 ===
--- ZODB3/Doc/zodb/about.html:1.2.6.13 Mon Mar 7 13:51:38 2005
+++ ZODB3/Doc/zodb/about.html Mon Mar 7 17:45:28 2005
@@ -47,7 +47,7 @@
About this document ...</A>
</H1>
<strong>ZODB/ZEO Programming Guide</strong>,
-March 7, 2005, Release 3.2.6b1
+March 7, 2005, Release 3.2.6
<p> This document was generated using the <a
href="http://saftsack.fs.uni-bayreuth.de/~latex2ht/">
<strong>LaTeX</strong>2<tt>HTML</tt></a> translator.
@@ -103,7 +103,7 @@
</div>
</div>
<hr />
-<span class="release-info">Release 3.2.6b1, documentation updated on March 7, 2005.</span>
+<span class="release-info">Release 3.2.6, documentation updated on March 7, 2005.</span>
</DIV>
<!--End of Navigation Panel-->
=== ZODB3/Doc/zodb/contents.html 1.2.6.13 => 1.2.6.14 ===
--- ZODB3/Doc/zodb/contents.html:1.2.6.13 Mon Mar 7 13:51:38 2005
+++ ZODB3/Doc/zodb/contents.html Mon Mar 7 17:45:28 2005
@@ -150,7 +150,7 @@
</div>
</div>
<hr />
-<span class="release-info">Release 3.2.6b1, documentation updated on March 7, 2005.</span>
+<span class="release-info">Release 3.2.6, documentation updated on March 7, 2005.</span>
</DIV>
<!--End of Navigation Panel-->
=== ZODB3/Doc/zodb/index.html 1.2.6.13 => 1.2.6.14 ===
--- ZODB3/Doc/zodb/index.html:1.2.6.13 Mon Mar 7 13:51:38 2005
+++ ZODB3/Doc/zodb/index.html Mon Mar 7 17:45:28 2005
@@ -44,7 +44,7 @@
<h1>ZODB/ZEO Programming Guide</h1>
<p><b><font size="+2">A.M. Kuchling</font></b></p>
<p><span class="email">amk at amk.ca</span></p>
-<p><strong>Release 3.2.6b1</strong><br />
+<p><strong>Release 3.2.6</strong><br />
<strong>March 7, 2005</strong></p>
<p></p>
</div>
@@ -163,7 +163,7 @@
</div>
</div>
<hr />
-<span class="release-info">Release 3.2.6b1, documentation updated on March 7, 2005.</span>
+<span class="release-info">Release 3.2.6, documentation updated on March 7, 2005.</span>
</DIV>
<!--End of Navigation Panel-->
=== ZODB3/Doc/zodb/node2.html 1.2.6.13 => 1.2.6.14 ===
--- ZODB3/Doc/zodb/node2.html:1.2.6.13 Mon Mar 7 13:51:38 2005
+++ ZODB3/Doc/zodb/node2.html Mon Mar 7 17:45:28 2005
@@ -335,7 +335,7 @@
</div>
</div>
<hr />
-<span class="release-info">Release 3.2.6b1, documentation updated on March 7, 2005.</span>
+<span class="release-info">Release 3.2.6, documentation updated on March 7, 2005.</span>
</DIV>
<!--End of Navigation Panel-->
=== ZODB3/Doc/zodb/node3.html 1.2.6.13 => 1.2.6.14 ===
--- ZODB3/Doc/zodb/node3.html:1.2.6.13 Mon Mar 7 13:51:38 2005
+++ ZODB3/Doc/zodb/node3.html Mon Mar 7 17:45:28 2005
@@ -127,8 +127,8 @@
</H2>
<P>
-The ZODB is conceptually simple. Python classes subclass a
-<tt class="class">Persistent</tt> class to become ZODB-aware.
+The ZODB is conceptually simple. Python classes subclass a
+<tt class="class">Persistent</tt> class to become ZODB-aware.
Instances of persistent objects are brought in from a permanent
storage medium, such as a disk file, when the program needs them, and
remain cached in RAM. The ZODB traps modifications to objects, so
@@ -146,7 +146,7 @@
software offers protection against such corruption by supporting four
useful properties, Atomicity, Consistency, Isolation, and Durability.
In computer science jargon these four terms are collectively dubbed
-the ACID properties, forming an acronym from their names.
+the ACID properties, forming an acronym from their names.
<P>
The ZODB provides all of the ACID properties. Definitions of the
@@ -155,7 +155,7 @@
<P>
<DL COMPACT>
<DT>Atomicity</DT>
-<DD>means that any changes to data made during a transaction
+<DD>means that any changes to data made during a transaction
are all-or-nothing. Either all the changes are applied, or none of
them are. If a program makes a bunch of modifications and then
crashes, the database won't be partially modified, potentially leaving
@@ -317,7 +317,7 @@
<div class="verbatim"><pre>
dbroot = conn.root()
-# Ensure that a 'userdb' key is present
+# Ensure that a 'userdb' key is present
# in the root
if not dbroot.has_key('userdb'):
from BTrees.OOBTree import OOBTree
@@ -333,10 +333,10 @@
<P>
<div class="verbatim"><pre># Create new User instance
-newuser = User()
+newuser = User()
# Add whatever attributes you want to track
-newuser.id = 'amk'
+newuser.id = 'amk'
newuser.first_name = 'Andrew' ; newuser.last_name = 'Kuchling'
...
@@ -367,7 +367,7 @@
<div class="verbatim"><pre>>>> newuser
<User instance at 81b1f40>
>>> newuser.first_name # Print initial value
-'Andrew'
+'Andrew'
>>> newuser.first_name = 'Bob' # Change first name
>>> newuser.first_name # Verify the change
'Bob'
@@ -397,10 +397,10 @@
<UL>
<LI>If you modify a mutable object that's the value of an object's
attribute, the ZODB can't catch that, and won't mark the object as
-dirty.
+dirty.
The solution is to either set the dirty bit yourself when you modify
mutable objects, or use a wrapper for Python's lists and dictionaries
-(<tt class="class">PersistentList</tt>,
+(<tt class="class">PersistentList</tt>,
<tt class="class">PersistentMapping</tt>)
that will set the dirty bit properly.
@@ -414,10 +414,10 @@
<P>
</LI>
-<LI>Recent versions of the ZODB allow writing a class with
+<LI>Recent versions of the ZODB allow writing a class with
<tt class="method">__setattr__</tt> , <tt class="method">__getattr__</tt>, or <tt class="method">__delattr__</tt> methods.
(Older versions didn't support this at all.)
-If you write such a <tt class="method">__setattr__</tt> or <tt class="method">__delattr__</tt> method,
+If you write such a <tt class="method">__setattr__</tt> or <tt class="method">__delattr__</tt> method,
its code has to set the dirty bit manually.
<P>
@@ -475,7 +475,7 @@
<P>
An obsolete way of doing this that's still supported is calling the
-<tt class="method">__changed__()</tt> method instead, but setting <tt class="member">_p_changed</tt>
+<tt class="method">__changed__()</tt> method instead, but setting <tt class="member">_p_changed</tt>
is the preferred way.
<P>
@@ -499,7 +499,7 @@
Alternatively, you could use a ZODB-aware list or mapping type that
handles the dirty bit for you. The ZODB comes with a
<tt class="class">PersistentMapping</tt> class, and I've contributed a
-<tt class="class">PersistentList</tt> class that's included in my ZODB distribution,
+<tt class="class">PersistentList</tt> class that's included in my ZODB distribution,
and may make it into a future upstream release of Zope.
<P>
@@ -518,7 +518,7 @@
<P>
This is a moderately annoying limitation. It means that the
<tt class="class">PersistentList</tt> class can't implement comparisons with regular
-sequence objects, and therefore statements such as
+sequence objects, and therefore statements such as
<code>if perslist==[]</code> don't do what you expect; instead of performing the correct
comparison, they return some arbitrary fixed result, so the <code>if</code>
statement will always be true or always be false. There is no good
@@ -545,7 +545,7 @@
<P>
While ExtensionClasses try to behave as much like regular Python
instances as possible, they are still not instances, and
-<tt class="function">type()</tt> doesn't return the <code>InstanceType</code> object, so
+<tt class="function">type()</tt> doesn't return the <code>InstanceType</code> object, so
no attempt is ever made to call <tt class="method">__cmp__</tt>. Perhaps Python 2.2
will repair this.
@@ -649,7 +649,7 @@
different class instances, then there's no longer any easy way to find
them all, short of writing a generalized object traversal function
that would walk over every single object in a ZODB, checking each one
-to see if it's an instance of <tt class="class">User</tt>.
+to see if it's an instance of <tt class="class">User</tt>.
<P>
Some OODBs support a feature called extents, which allow quickly
@@ -694,7 +694,7 @@
</div>
</div>
<hr />
-<span class="release-info">Release 3.2.6b1, documentation updated on March 7, 2005.</span>
+<span class="release-info">Release 3.2.6, documentation updated on March 7, 2005.</span>
</DIV>
<!--End of Navigation Panel-->
=== ZODB3/Doc/zodb/node5.html 1.2.6.13 => 1.2.6.14 ===
--- ZODB3/Doc/zodb/node5.html:1.2.6.13 Mon Mar 7 13:51:38 2005
+++ ZODB3/Doc/zodb/node5.html Mon Mar 7 17:45:29 2005
@@ -306,7 +306,7 @@
</div>
</div>
<hr />
-<span class="release-info">Release 3.2.6b1, documentation updated on March 7, 2005.</span>
+<span class="release-info">Release 3.2.6, documentation updated on March 7, 2005.</span>
</DIV>
<!--End of Navigation Panel-->
=== ZODB3/Doc/zodb/node6.html 1.2.6.13 => 1.2.6.14 ===
--- ZODB3/Doc/zodb/node6.html:1.2.6.13 Mon Mar 7 13:51:38 2005
+++ ZODB3/Doc/zodb/node6.html Mon Mar 7 17:45:29 2005
@@ -480,7 +480,7 @@
</div>
</div>
<hr />
-<span class="release-info">Release 3.2.6b1, documentation updated on March 7, 2005.</span>
+<span class="release-info">Release 3.2.6, documentation updated on March 7, 2005.</span>
</DIV>
<!--End of Navigation Panel-->
=== ZODB3/Doc/zodb/node7.html 1.2.6.13 => 1.2.6.14 ===
--- ZODB3/Doc/zodb/node7.html:1.2.6.13 Mon Mar 7 13:51:38 2005
+++ ZODB3/Doc/zodb/node7.html Mon Mar 7 17:45:29 2005
@@ -116,7 +116,7 @@
</div>
</div>
<hr />
-<span class="release-info">Release 3.2.6b1, documentation updated on March 7, 2005.</span>
+<span class="release-info">Release 3.2.6, documentation updated on March 7, 2005.</span>
</DIV>
<!--End of Navigation Panel-->
=== ZODB3/Doc/zodb/node8.html 1.2.6.13 => 1.2.6.14 ===
--- ZODB3/Doc/zodb/node8.html:1.2.6.13 Mon Mar 7 13:51:38 2005
+++ ZODB3/Doc/zodb/node8.html Mon Mar 7 17:45:29 2005
@@ -575,7 +575,7 @@
</div>
</div>
<hr />
-<span class="release-info">Release 3.2.6b1, documentation updated on March 7, 2005.</span>
+<span class="release-info">Release 3.2.6, documentation updated on March 7, 2005.</span>
</DIV>
<!--End of Navigation Panel-->
=== ZODB3/Doc/zodb/zeo.html 1.2.6.13 => 1.2.6.14 ===
--- ZODB3/Doc/zodb/zeo.html:1.2.6.13 Mon Mar 7 13:51:38 2005
+++ ZODB3/Doc/zodb/zeo.html Mon Mar 7 17:45:29 2005
@@ -420,7 +420,7 @@
</div>
</div>
<hr />
-<span class="release-info">Release 3.2.6b1, documentation updated on March 7, 2005.</span>
+<span class="release-info">Release 3.2.6, documentation updated on March 7, 2005.</span>
</DIV>
<!--End of Navigation Panel-->
=== ZODB3/Doc/zodb/zodb.html 1.2.6.13 => 1.2.6.14 ===
--- ZODB3/Doc/zodb/zodb.html:1.2.6.13 Mon Mar 7 13:51:38 2005
+++ ZODB3/Doc/zodb/zodb.html Mon Mar 7 17:45:29 2005
@@ -44,7 +44,7 @@
<h1>ZODB/ZEO Programming Guide</h1>
<p><b><font size="+2">A.M. Kuchling</font></b></p>
<p><span class="email">amk at amk.ca</span></p>
-<p><strong>Release 3.2.6b1</strong><br />
+<p><strong>Release 3.2.6</strong><br />
<strong>March 7, 2005</strong></p>
<p></p>
</div>
@@ -163,7 +163,7 @@
</div>
</div>
<hr />
-<span class="release-info">Release 3.2.6b1, documentation updated on March 7, 2005.</span>
+<span class="release-info">Release 3.2.6, documentation updated on March 7, 2005.</span>
</DIV>
<!--End of Navigation Panel-->
More information about the Zodb-checkins
mailing list