Merge 'trunk' into 'replication_dedux'

r13166@dev (orig r4392):  castaway | 2008-05-19 16:57:25 -0500
Added doc for "for => update" attribute, thanks StuartL.

r13167@dev (orig r4393):  castaway | 2008-05-19 16:59:16 -0500
Oops, =cut after the pod not in the middle

r13272@dev (orig r4419):  ash | 2008-05-27 05:41:44 -0500
Update FAQ to mention behavour of scalar refs w.r.t. update
r13273@dev (orig r4420):  ash | 2008-05-27 07:49:09 -0500
Add set_cache example to cookbook
r13274@dev (orig r4421):  ash | 2008-05-27 07:50:10 -0500
Fix var name typo in cookbook
r13376@dev (orig r4422):  matthewt | 2008-05-27 08:31:58 -0500
version bump, deprecated ResultSetManager