Boost-Commit :

Date view	Thread view	Subject view	Author view

Subject: [Boost-commit] svn:boost r56357 - in sandbox/stm/branches/vbe/libs/stm/doc: . html html/toward_boost_stm html/toward_boost_stm/appendices html/toward_boost_stm/reference html/toward_boost_stm/users_guide reference
From: vicente.botet_at_[hidden]
Date: 2009-09-22 14:14:17

Author: viboes
Date: 2009-09-22 14:14:13 EDT (Tue, 22 Sep 2009)
New Revision: 56357
URL: http://svn.boost.org/trac/boost/changeset/56357

Log:
TBoost.Stm vbe
* DRAFT documentation ongoing

Added:
   sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/base_transaction_object_hpp.html (contents, props changed)
   sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/cache_fct_hpp.html (contents, props changed)
   sandbox/stm/branches/vbe/libs/stm/doc/reference/base_transaction_object.qbk (contents, props changed)
   sandbox/stm/branches/vbe/libs/stm/doc/reference/cache_fct.qbk (contents, props changed)
   sandbox/stm/branches/vbe/libs/stm/doc/stm.pdf (contents, props changed)
Text files modified:
   sandbox/stm/branches/vbe/libs/stm/doc/html/index.html | 17
   sandbox/stm/branches/vbe/libs/stm/doc/html/standalone_HTML.manifest | 8
   sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/changes.html | 4
   sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/implementation.html | 10
   sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/rationale.html | 66 +++---
   sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/todo.html | 12
   sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference.html | 83 ++++---
   sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/base_contention_manager_hpp.html | 8
   sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/base_transaction_hpp.html | 393 -------------------------------------
   sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/data_types_hpp.html | 40 +++
   sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/exceptions_hpp.html | 6
   sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/language_like_hpp.html | 8
   sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/non_tx_smart_ptr_hpp.html | 6
   sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/transaction_bookkeeping_hpp.html | 6
   sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/transaction_hpp.html | 8
   sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/transaction_object_hpp.html | 413 +++------------------------------------
   sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/transactional_object_hpp.html | 6
   sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/users_guide/tutorial.html | 14
   sandbox/stm/branches/vbe/libs/stm/doc/reference.qbk | 13
   sandbox/stm/branches/vbe/libs/stm/doc/reference/data_types.qbk | 18 +
   sandbox/stm/branches/vbe/libs/stm/doc/reference/transaction_object.qbk | 198 -------------------
   sandbox/stm/branches/vbe/libs/stm/doc/tutorial.qbk | 4
   22 files changed, 230 insertions(+), 1111 deletions(-)

Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/index.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/index.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/index.html 2009-09-22 14:14:13 EDT (Tue, 22 Sep 2009)
@@ -52,12 +52,19 @@
</dl></dd>
<dt>Reference</dt>
<dd><dl>
+<dt><a href="toward_boost_stm/reference/base_contention_manager_hpp.html">
+ Header <code class="computeroutput"><boost/stm/base_contention_manager.hpp></code></a></dt>
+<dt><a href="toward_boost_stm/reference/base_transaction_object_hpp.html">
+ Header <code class="computeroutput"><boost/stm/base_transaction_object.hpp></code></a></dt>
+<dt> Header <boost/stm/cache_fct.hpp></dt>
<dt> Header <boost/stm/data_types.hpp></dt>
<dt> Header <boost/stm/exceptions.hpp></dt>
+<dt><a href="toward_boost_stm/reference/language_like_hpp.html"> Header
+ <code class="computeroutput"><boost/stm/language_like.hpp></code></a></dt>
<dt><a href="toward_boost_stm/reference/transaction_hpp.html"> Header
 <code class="computeroutput"><boost/stm/transaction.hpp></code></a></dt>
-<dt><a href="toward_boost_stm/reference/base_transaction_hpp.html"> Header
- <code class="computeroutput"><boost/stm/base_transaction.hpp></code></a></dt>
+<dt><a href="toward_boost_stm/reference/transaction_object_hpp.html"> Header
+ <code class="computeroutput"><boost/stm/transaction_object.hpp></code></a></dt>
<dt><a href="toward_boost_stm/reference/transactional_object_hpp.html">
 Header <code class="computeroutput"><boost/stm/transactional_object.hpp></code></a></dt>
<dt> Header <boost/stm/tx_ptr.hpp></dt>
@@ -65,10 +72,6 @@
 <code class="computeroutput"><boost/stm/tx_smart_ptr.hpp></code></a></dt>
<dt><a href="toward_boost_stm/reference/non_tx_smart_ptr_hpp.html"> Header
 <code class="computeroutput"><boost/stm/non_tx_smart_ptr.hpp></code></a></dt>
-<dt><a href="toward_boost_stm/reference/base_contention_manager_hpp.html">
- Header <code class="computeroutput"><boost/stm/base_contention_manager.hpp></code></a></dt>
-<dt><a href="toward_boost_stm/reference/language_like_hpp.html"> Header
- <code class="computeroutput"><boost/stm/language_like.hpp></code></a></dt>
<dt><a href="toward_boost_stm/reference/transaction_bookkeeping_hpp.html">
 Header <code class="computeroutput"><boost/stm/transaction_bookkeeping.hpp></code></a></dt>
</dl></dd>
@@ -107,7 +110,7 @@
 
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
-<td align="left">Last revised: September 20, 2009 at 23:08:52 GMT</td>
+<td align="left">Last revised: September 22, 2009 at 16:33:31 GMT</td>
<td align="right"><div class="copyright-footer"></div></td>
</tr></table>
<hr>

Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/standalone_HTML.manifest
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/standalone_HTML.manifest (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/standalone_HTML.manifest 2009-09-22 14:14:13 EDT (Tue, 22 Sep 2009)
@@ -7,16 +7,18 @@
toward_boost_stm/users_guide/ext_references.html
toward_boost_stm/users_guide/glosary.html
toward_boost_stm/reference.html
+toward_boost_stm/reference/base_contention_manager_hpp.html
+toward_boost_stm/reference/base_transaction_object_hpp.html
+toward_boost_stm/reference/cache_fct_hpp.html
toward_boost_stm/reference/data_types_hpp.html
toward_boost_stm/reference/exceptions_hpp.html
+toward_boost_stm/reference/language_like_hpp.html
toward_boost_stm/reference/transaction_hpp.html
-toward_boost_stm/reference/base_transaction_hpp.html
+toward_boost_stm/reference/transaction_object_hpp.html
toward_boost_stm/reference/transactional_object_hpp.html
toward_boost_stm/reference/tx_ptr_hpp.html
toward_boost_stm/reference/tx_smart_ptr_hpp.html
toward_boost_stm/reference/non_tx_smart_ptr_hpp.html
-toward_boost_stm/reference/base_contention_manager_hpp.html
-toward_boost_stm/reference/language_like_hpp.html
toward_boost_stm/reference/transaction_bookkeeping_hpp.html
toward_boost_stm/examples.html
toward_boost_stm/appendices.html

Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/changes.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/changes.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/changes.html 2009-09-22 14:14:13 EDT (Tue, 22 Sep 2009)
@@ -27,7 +27,7 @@
<a name="toward_boost_stm.appendices.changes"></a><a class="link" href="changes.html" title="Appendix A: History"> Appendix A: History</a>
</h3></div></div></div>
<a name="toward_boost_stm.appendices.changes._emphasis_role__bold__version_0_1__xx_yy__2009__emphasis___emphasis_announcement_of_stm__emphasis_"></a><h5>
-<a name="id4897896"></a>
+<a name="id4898225"></a>
 <a class="link" href="changes.html#toward_boost_stm.appendices.changes._emphasis_role__bold__version_0_1__xx_yy__2009__emphasis___emphasis_announcement_of_stm__emphasis_">Version 0.1, XX YY, 2009 Announcement of
 STM</a>
 </h5>
@@ -47,7 +47,7 @@
 </li>
</ul></div>
<a name="toward_boost_stm.appendices.changes._emphasis_role__bold__tickets___emphasis_"></a><h5>
-<a name="id4897968"></a>
+<a name="id4898297"></a>
 <a class="link" href="changes.html#toward_boost_stm.appendices.changes._emphasis_role__bold__tickets___emphasis_">Tickets:</a>
 </h5>

Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/implementation.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/implementation.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/implementation.html 2009-09-22 14:14:13 EDT (Tue, 22 Sep 2009)
@@ -49,7 +49,7 @@
 constructs are shown in Figures 6 and 8, respectively.
 
<a name="toward_boost_stm.appendices.implementation.language_like_macro_blocks.locking_macros"></a><h6>
-<a name="id4913501"></a>
+<a name="id4913883"></a>
 <a class="link" href="implementation.html#toward_boost_stm.appendices.implementation.language_like_macro_blocks.locking_macros">Locking
 Macros</a>
 </h6>
@@ -72,7 +72,7 @@
 are executed once and only once.
 
<a name="toward_boost_stm.appendices.implementation.language_like_macro_blocks.transaction_macros"></a><h6>
-<a name="id4913550"></a>
+<a name="id4913947"></a>
 <a class="link" href="implementation.html#toward_boost_stm.appendices.implementation.language_like_macro_blocks.transaction_macros">Transaction
 Macros</a>
 </h6>
@@ -121,7 +121,7 @@
 transaction is aborted.
 
<a name="toward_boost_stm.appendices.implementation.language_like_macro_blocks.correcting_non_compliant_compilers"></a><h6>
-<a name="id4913656"></a>
+<a name="id4914053"></a>
 <a class="link" href="implementation.html#toward_boost_stm.appendices.implementation.language_like_macro_blocks.correcting_non_compliant_compilers">Correcting
 Non-Compliant Compilers</a>
 </h6>
@@ -154,11 +154,11 @@
<a name="toward_boost_stm.appendices.implementation.cache"></a><a class="link" href="implementation.html#toward_boost_stm.appendices.implementation.cache" title="Cache">Cache</a>
</h4></div></div></div>
<a name="toward_boost_stm.appendices.implementation.cache.dispersed"></a><h6>
-<a name="id4913785"></a>
+<a name="id4914181"></a>
 <a class="link" href="implementation.html#toward_boost_stm.appendices.implementation.cache.dispersed">Dispersed</a>
 </h6>
<a name="toward_boost_stm.appendices.implementation.cache.compact"></a><h6>
-<a name="id4913806"></a>
+<a name="id4914202"></a>
 <a class="link" href="implementation.html#toward_boost_stm.appendices.implementation.cache.compact">Compact</a>
 </h6>
</div>

Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/rationale.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/rationale.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/rationale.html 2009-09-22 14:14:13 EDT (Tue, 22 Sep 2009)
@@ -260,7 +260,7 @@
 read).
 
<div class="table">
-<a name="id4898495"></a>Table 1.1. Comparaison with other STM systems
+<a name="id4898826"></a>Table 1.1. Comparaison with other STM systems
<div class="table-contents"><table class="table" summary="Comparaison with other STM systems">
<colgroup>
<col>
@@ -463,7 +463,7 @@
 handle each specific problem with the most appropriate configuration.
 
<div class="table">
-<a name="id4898890"></a>Table 1.2. Consistency versus Updating policies composition
+<a name="id4899202"></a>Table 1.2. Consistency versus Updating policies composition
<div class="table-contents"><table class="table" summary="Consistency versus Updating policies composition">
<colgroup>
<col>
@@ -615,7 +615,7 @@
 management</a>
</h5></div></div></div>
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.contention_management.priority_based_tasks"></a><h6>
-<a name="id4899210"></a>
+<a name="id4899534"></a>
 <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.contention_management.priority_based_tasks">Priority-Based
 Tasks</a>
 </h6>
@@ -630,7 +630,7 @@
 cases, user-defined priority-based transactions are necessary.
 
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.contention_management.approach"></a><h6>
-<a name="id4899248"></a>
+<a name="id4899573"></a>
 <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.contention_management.approach">Approach</a>
 </h6>

@@ -646,7 +646,7 @@
 checking models. Last, we present our experimental results.
 
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.contention_management.attacking__amp__victim_transactions"></a><h6>
-<a name="id4899301"></a>
+<a name="id4899611"></a>
 <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.contention_management.attacking__amp__victim_transactions">Attacking
 & Victim Transactions</a>
 </h6>
@@ -666,7 +666,7 @@
 transaction since Ta may abort it.
 
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.contention_management.user_defined_priority_based_transactions"></a><h6>
-<a name="id4899349"></a>
+<a name="id4899660"></a>
 <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.contention_management.user_defined_priority_based_transactions">User-Defined
 Priority-Based Transactions</a>
 </h6>
@@ -687,7 +687,7 @@
 priority-based transactional environments.
 
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.contention_management.extensible_polymorphic_contention_management_interface"></a><h6>
-<a name="id4899399"></a>
+<a name="id4899709"></a>
 <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.contention_management.extensible_polymorphic_contention_management_interface">Extensible
 Polymorphic Contention Management Interface</a>
 </h6>
@@ -781,7 +781,7 @@
 of experimental benchmarks on .
 
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.introduction"></a><h6>
-<a name="id4900106"></a>
+<a name="id4900448"></a>
 <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.introduction">Introduction</a>
 </h6>

@@ -834,7 +834,7 @@
 </li>
</ol></div>
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.background"></a><h6>
-<a name="id4900206"></a>
+<a name="id4900549"></a>
 <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.background">Background</a>
 </h6>

@@ -945,7 +945,7 @@
 later sections.
 
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.locks_outside_of_transactions__lot_"></a><h6>
-<a name="id4900772"></a>
+<a name="id4901115"></a>
 <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.locks_outside_of_transactions__lot_">Locks
 Outside of Transactions (LoT)</a>
 </h6>
@@ -996,7 +996,7 @@
27 int lock3() { /* no conflict */ }
</pre>
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lot_full_lock_protection"></a><h6>
-<a name="id4901914"></a>
+<a name="id4902256"></a>
 <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lot_full_lock_protection">LoT
 Full Lock Protection</a>
 </h6>
@@ -1026,7 +1026,7 @@
 stalling.
 
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lot_tm_lock_protection"></a><h6>
-<a name="id4901994"></a>
+<a name="id4902337"></a>
 <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lot_tm_lock_protection">LoT
 TM-Lock Protection</a>
 </h6>
@@ -1069,7 +1069,7 @@
 the third lock protection policy.
 
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lot_tx_lock_protection"></a><h6>
-<a name="id4902177"></a>
+<a name="id4902510"></a>
 <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lot_tx_lock_protection">LoT
 TX-Lock Protection</a>
 </h6>
@@ -1112,7 +1112,7 @@
 cooperative performance while still adhering to the rule.
 
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.locks_inside_of_transactions__lit_"></a><h6>
-<a name="id4902702"></a>
+<a name="id4903035"></a>
 <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.locks_inside_of_transactions__lit_">Locks
 Inside of Transactions (LiT)</a>
 </h6>
@@ -1226,7 +1226,7 @@
 for the completeness of the example.
 
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lit_full_lock_protection"></a><h6>
-<a name="id4903745"></a>
+<a name="id4904093"></a>
 <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lit_full_lock_protection">LiT
 Full-Lock Protection</a>
 </h6>
@@ -1256,7 +1256,7 @@
 are all allowed to resume.
 
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lit_tm_lock_protection"></a><h6>
-<a name="id4903818"></a>
+<a name="id4904154"></a>
 <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lit_tm_lock_protection">LiT
 TM-Lock Protection</a>
 </h6>
@@ -1286,7 +1286,7 @@
 LiT protection policy, LiT TX-lock protection.
 
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lit_tx_lock_protection"></a><h6>
-<a name="id4903880"></a>
+<a name="id4904216"></a>
 <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lit_tx_lock_protection">LiT
 TX-Lock Protection</a>
 </h6>
@@ -1326,7 +1326,7 @@
 passed. When lockL3 completes tx3 begins and runs through to completion.
 
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lock_composition"></a><h6>
-<a name="id4903970"></a>
+<a name="id4904312"></a>
 <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lock_composition">Lock
 Composition</a>
 </h6>
@@ -1410,7 +1410,7 @@
 lock until the transaction commits.
 
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.criticality_of_lit_lock_composition"></a><h6>
-<a name="id4904675"></a>
+<a name="id4905032"></a>
 <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.criticality_of_lit_lock_composition">Criticality
 of LiT Lock Composition</a>
 </h6>
@@ -1461,7 +1461,7 @@
 cumulative affects of the move() operation.
 
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.understanding_lit_lock_composition"></a><h6>
-<a name="id4905286"></a>
+<a name="id4905643"></a>
 <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.understanding_lit_lock_composition">Understanding
 LiT Lock Composition</a>
 </h6>
@@ -1550,7 +1550,7 @@
 shared memory x2.
 
<a name="toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lit_lock_identification"></a><h6>
-<a name="id4906362"></a>
+<a name="id4906719"></a>
 <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.tm_specific_concepts.lock_aware_transaction.lit_lock_identification">LiT
 Lock Identification</a>
 </h6>
@@ -1855,7 +1855,7 @@
 The following table is a compilation of the preceding analysis:
 
<div class="table">
-<a name="id4906890"></a>Table 1.3. Comparaison with other STM systems
+<a name="id4907272"></a>Table 1.3. Comparaison with other STM systems
<div class="table-contents"><table class="table" summary="Comparaison with other STM systems">
<colgroup><col></colgroup>
<thead><tr>
@@ -2136,7 +2136,7 @@
 support in the near future [4].
 
<div class="table">
-<a name="id4908020"></a>Table 1.4. Comparaison with other STM systems
+<a name="id4908420"></a>Table 1.4. Comparaison with other STM systems
<div class="table-contents"><table class="table" summary="Comparaison with other STM systems">
<colgroup>
<col>
@@ -2234,7 +2234,7 @@
 Table 1. TBoost.STM Mutual Exclusion Locking Parallel Constructs.
 
<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.library_based_lock_implementations"></a><h6>
-<a name="id4908228"></a>
+<a name="id4908628"></a>
 <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.library_based_lock_implementations">Library-based
 Lock Implementations</a>
 </h6>
@@ -2282,7 +2282,7 @@
 scoping and programmer error.
 
<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.pitfalls_in_scoping_of_automatic_object_locks"></a><h6>
-<a name="id4908625"></a>
+<a name="id4909025"></a>
 <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.pitfalls_in_scoping_of_automatic_object_locks">Pitfalls
 in Scoping of Automatic Object Locks</a>
 </h6>
@@ -2355,7 +2355,7 @@
 of locks results in unoptimized performance.
 
<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.library_based_transaction_implementations"></a><h6>
-<a name="id4909080"></a>
+<a name="id4909460"></a>
 <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.library_based_transaction_implementations">Library-based
 Transaction Implementations</a>
 </h6>
@@ -2409,7 +2409,7 @@
 behaviors.
 
<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.pitfalls_in_transactional_execution_of_automatic_objects"></a><h6>
-<a name="id4909452"></a>
+<a name="id4909847"></a>
 <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.pitfalls_in_transactional_execution_of_automatic_objects">Pitfalls
 in Transactional Execution of Automatic Objects</a>
 </h6>
@@ -2504,7 +2504,7 @@
 of direct language integration of TM instead of API-only approaches.
 
<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.disadvantages_of_language_based_transactional_integration"></a><h6>
-<a name="id4910450"></a>
+<a name="id4910845"></a>
 <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.disadvantages_of_language_based_transactional_integration">Disadvantages
 of Language Based Transactional Integration</a>
 </h6>
@@ -2541,7 +2541,7 @@
 objects nor language-based parallel abstractions alone can provide.
 
<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.parallel_constructs_for_mutually_exclusive_locks"></a><h6>
-<a name="id4910527"></a>
+<a name="id4910938"></a>
 <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.parallel_constructs_for_mutually_exclusive_locks">Parallel
 Constructs for Mutually Exclusive Locks</a>
 </h6>
@@ -2577,7 +2577,7 @@
 in client code.
 
<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.exception_based_timed_locks"></a><h6>
-<a name="id4911030"></a>
+<a name="id4911441"></a>
 <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.exception_based_timed_locks">Exception-based
 Timed Locks</a>
 </h6>
@@ -2664,7 +2664,7 @@
Figure 12. Optimized Timed Locking with TBoost.STM.
</pre>
<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.parallel_constructs_for_transactional_memory"></a><h6>
-<a name="id4912318"></a>
+<a name="id4912700"></a>
 <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.parallel_constructs_for_transactional_memory">Parallel
 Constructs for Transactional Memory</a>
 </h6>
@@ -2742,7 +2742,7 @@
 correct behavior and then throwing an exception upward.
 
<a name="toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.transaction_nesting"></a><h6>
-<a name="id4912962"></a>
+<a name="id4913345"></a>
 <a class="link" href="rationale.html#toward_boost_stm.appendices.rationale.c___and_library_specific_concepts.language_like_macro_blocks.transaction_nesting">Transaction
 Nesting</a>
 </h6>
@@ -2802,7 +2802,7 @@
 with other STM systems</a>
</h4></div></div></div>
<div class="table">
-<a name="id4913083"></a>Table 1.5. Comparaison
+<a name="id4913465"></a>Table 1.5. Comparaison
 with other STM systems
<div class="table-contents"><table class="table" summary="Comparaison
 with other STM systems">

Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/todo.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/todo.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/appendices/todo.html 2009-09-22 14:14:13 EDT (Tue, 22 Sep 2009)
@@ -40,7 +40,7 @@
 to do before review</a>
</h4></div></div></div>
<a name="toward_boost_stm.appendices.todo.tasks_to_do_before_review.interface"></a><h6>
-<a name="id4914141"></a>
+<a name="id4914537"></a>
 <a class="link" href="todo.html#toward_boost_stm.appendices.todo.tasks_to_do_before_review.interface">Interface</a>
 </h6>
<div class="itemizedlist"><ul type="disc">
@@ -59,7 +59,7 @@
 </li>
</ul></div>
<a name="toward_boost_stm.appendices.todo.tasks_to_do_before_review.boostifying_stm"></a><h6>
-<a name="id4914196"></a>
+<a name="id4914598"></a>
 <a class="link" href="todo.html#toward_boost_stm.appendices.todo.tasks_to_do_before_review.boostifying_stm">Boostifying
 STM</a>
 </h6>
@@ -135,7 +135,7 @@
 </li>
</ul></div>
<a name="toward_boost_stm.appendices.todo.tasks_to_do_before_review.implementation"></a><h6>
-<a name="id4914374"></a>
+<a name="id4914776"></a>
 <a class="link" href="todo.html#toward_boost_stm.appendices.todo.tasks_to_do_before_review.implementation">Implementation</a>
 </h6>
<div class="itemizedlist"><ul type="disc">
@@ -157,21 +157,21 @@
 </li>
</ul></div>
<a name="toward_boost_stm.appendices.todo.tasks_to_do_before_review.tests"></a><h6>
-<a name="id4914433"></a>
+<a name="id4914835"></a>
 <a class="link" href="todo.html#toward_boost_stm.appendices.todo.tasks_to_do_before_review.tests">Tests</a>
 </h6>
<div class="itemizedlist"><ul type="disc"><li>
 Add unit tests
 </li></ul></div>
<a name="toward_boost_stm.appendices.todo.tasks_to_do_before_review.benchmarks"></a><h6>
-<a name="id4914464"></a>
+<a name="id4914866"></a>
 <a class="link" href="todo.html#toward_boost_stm.appendices.todo.tasks_to_do_before_review.benchmarks">Benchmarks</a>
 </h6>
<div class="itemizedlist"><ul type="disc"><li>
 Add some specific benchmarks.
 </li></ul></div>
<a name="toward_boost_stm.appendices.todo.tasks_to_do_before_review.documentation"></a><h6>
-<a name="id4914495"></a>
+<a name="id4914897"></a>
 <a class="link" href="todo.html#toward_boost_stm.appendices.todo.tasks_to_do_before_review.documentation">Documentation</a>
 </h6>
<div class="itemizedlist"><ul type="disc">

Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference.html 2009-09-22 14:14:13 EDT (Tue, 22 Sep 2009)
@@ -7,7 +7,7 @@
<link rel="start" href="../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="prev" href="users_guide/glosary.html" title="Glossary">
-<link rel="next" href="reference/data_types_hpp.html" title="Header <boost/stm/data_types.hpp>">
+<link rel="next" href="reference/base_contention_manager_hpp.html" title="Header <boost/stm/base_contention_manager.hpp>">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -20,13 +20,34 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="users_guide/glosary.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="reference/data_types_hpp.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="users_guide/glosary.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="reference/base_contention_manager_hpp.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
<a name="toward_boost_stm.reference"></a><a class="link" href="reference.html" title="Reference">Reference</a>
</h2></div></div></div>
<div class="toc"><dl>
+<dt><a href="reference/base_contention_manager_hpp.html">
+ Header <code class="computeroutput"><boost/stm/base_contention_manager.hpp></code></a></dt>
+<dd><dl><dt><a href="reference/base_contention_manager_hpp.html#toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_">Abstract
+ Class <code class="computeroutput">base_contention_manager</code></a></dt></dl></dd>
+<dt><a href="reference/base_transaction_object_hpp.html">
+ Header <code class="computeroutput"><boost/stm/base_transaction_object.hpp></code></a></dt>
+<dd><dl><dt><a href="reference/base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_">Abstract
+ Class <code class="computeroutput">base_transaction_object</code></a></dt></dl></dd>
+<dt> Header <boost/stm/cache_fct.hpp></dt>
+<dd><dl>
+<dt><a href="reference/cache_fct_hpp.html#toward_boost_stm.reference.cache_fct_hpp.template_function__cache_clone_____">Template
+ Function <code class="computeroutput">cache_clone<>()</code></a></dt>
+<dt><a href="reference/cache_fct_hpp.html#toward_boost_stm.reference.cache_fct_hpp.template_function__cache_copy_____">Template
+ Function <code class="computeroutput">cache_copy<>()</code></a></dt>
+<dt><a href="reference/cache_fct_hpp.html#toward_boost_stm.reference.cache_fct_hpp.function__cache_release_____">Function
+ <code class="computeroutput">cache_release<>()</code></a></dt>
+<dt><a href="reference/cache_fct_hpp.html#toward_boost_stm.reference.cache_fct_hpp.template_function__cache_allocate_____">Template
+ Function <code class="computeroutput">cache_allocate<>()</code></a></dt>
+<dt><a href="reference/cache_fct_hpp.html#toward_boost_stm.reference.cache_fct_hpp.template_function__cache_deallocate_____">Template
+ Function <code class="computeroutput">cache_deallocate<>()</code></a></dt>
+</dl></dd>
<dt> Header <boost/stm/data_types.hpp></dt>
<dd><dl>
<dt><a href="reference/data_types_hpp.html#toward_boost_stm.reference.data_types_hpp.enum__transaction_type_">Enum
@@ -41,6 +62,22 @@
<dt> Header <boost/stm/exceptions.hpp></dt>
<dd><dl><dt><a href="reference/exceptions_hpp.html#toward_boost_stm.reference.exceptions_hpp.class__aborted_transaction_exception_">Class
 <code class="computeroutput">aborted_transaction_exception</code></a></dt></dl></dd>
+<dt><a href="reference/language_like_hpp.html"> Header
+ <code class="computeroutput"><boost/stm/language_like.hpp></code></a></dt>
+<dd><dl>
+<dt><a href="reference/language_like_hpp.html#toward_boost_stm.reference.language_like_hpp.macro__atomic_">Macro
+ <code class="computeroutput">atomic</code></a></dt>
+<dt><a href="reference/language_like_hpp.html#toward_boost_stm.reference.language_like_hpp.macro__try_atomic_">Macro
+ <code class="computeroutput">try_atomic</code></a></dt>
+<dt><a href="reference/language_like_hpp.html#toward_boost_stm.reference.language_like_hpp.macro__use_atomic_">Macro
+ <code class="computeroutput">use_atomic</code></a></dt>
+<dt><a href="reference/language_like_hpp.html#toward_boost_stm.reference.language_like_hpp.macro__catch_before_retry_">Macro
+ <code class="computeroutput">catch_before_retry</code></a></dt>
+<dt><a href="reference/language_like_hpp.html#toward_boost_stm.reference.language_like_hpp.macro__before_retry_">Macro
+ <code class="computeroutput">before_retry</code></a></dt>
+<dt><a href="reference/language_like_hpp.html#toward_boost_stm.reference.language_like_hpp.macro__end_atom_">Macro
+ <code class="computeroutput">end_atom</code></a></dt>
+</dl></dd>
<dt><a href="reference/transaction_hpp.html"> Header
 <code class="computeroutput"><boost/stm/transaction.hpp></code></a></dt>
<dd><dl>
@@ -49,24 +86,12 @@
<dt><a href="reference/transaction_hpp.html#toward_boost_stm.reference.transaction_hpp.struct__thread_initializer_">Struct
 <code class="computeroutput">thread_initializer</code></a></dt>
</dl></dd>
-<dt><a href="reference/base_transaction_hpp.html"> Header
- <code class="computeroutput"><boost/stm/base_transaction.hpp></code></a></dt>
+<dt><a href="reference/transaction_object_hpp.html"> Header
+ <code class="computeroutput"><boost/stm/transaction_object.hpp></code></a></dt>
<dd><dl>
-<dt><a href="reference/base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_">Abstract
- Class <code class="computeroutput">base_transaction_object</code></a></dt>
-<dt><a href="reference/base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.template_function__cache_clone_____">Template
- Function <code class="computeroutput">cache_clone<>()</code></a></dt>
-<dt><a href="reference/base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.template_function__cache_copy_____">Template
- Function <code class="computeroutput">cache_copy<>()</code></a></dt>
-<dt><a href="reference/base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.function__cache_release_____">Function
- <code class="computeroutput">cache_release<>()</code></a></dt>
-<dt><a href="reference/base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.template_function__cache_allocate_____">Template
- Function <code class="computeroutput">cache_allocate<>()</code></a></dt>
-<dt><a href="reference/base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.template_function__cache_deallocate_____">Template
- Function <code class="computeroutput">cache_deallocate<>()</code></a></dt>
-<dt><a href="reference/base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.template_class__transaction_object___">Template
+<dt><a href="reference/transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___">Template
 Class <code class="computeroutput">transaction_object<></code></a></dt>
-<dt><a href="reference/base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.template_class__native_trans___">Template
+<dt><a href="reference/transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__native_trans___">Template
 Class <code class="computeroutput">native_trans<></code></a></dt>
</dl></dd>
<dt><a href="reference/transactional_object_hpp.html">
@@ -104,26 +129,6 @@
<dt><a href="reference/non_tx_smart_ptr_hpp.html#toward_boost_stm.reference.non_tx_smart_ptr_hpp.template_class__wr_ptr___">Template
 Class <code class="computeroutput">wr_ptr<></code></a></dt>
</dl></dd>
-<dt><a href="reference/base_contention_manager_hpp.html">
- Header <code class="computeroutput"><boost/stm/base_contention_manager.hpp></code></a></dt>
-<dd><dl><dt><a href="reference/base_contention_manager_hpp.html#toward_boost_stm.reference.base_contention_manager_hpp.abstract_class__base_contention_manager_">Abstract
- Class <code class="computeroutput">base_contention_manager</code></a></dt></dl></dd>
-<dt><a href="reference/language_like_hpp.html"> Header
- <code class="computeroutput"><boost/stm/language_like.hpp></code></a></dt>
-<dd><dl>
-<dt><a href="reference/language_like_hpp.html#toward_boost_stm.reference.language_like_hpp.macro__atomic_">Macro
- <code class="computeroutput">atomic</code></a></dt>
-<dt><a href="reference/language_like_hpp.html#toward_boost_stm.reference.language_like_hpp.macro__try_atomic_">Macro
- <code class="computeroutput">try_atomic</code></a></dt>
-<dt><a href="reference/language_like_hpp.html#toward_boost_stm.reference.language_like_hpp.macro__use_atomic_">Macro
- <code class="computeroutput">use_atomic</code></a></dt>
-<dt><a href="reference/language_like_hpp.html#toward_boost_stm.reference.language_like_hpp.macro__catch_before_retry_">Macro
- <code class="computeroutput">catch_before_retry</code></a></dt>
-<dt><a href="reference/language_like_hpp.html#toward_boost_stm.reference.language_like_hpp.macro__before_retry_">Macro
- <code class="computeroutput">before_retry</code></a></dt>
-<dt><a href="reference/language_like_hpp.html#toward_boost_stm.reference.language_like_hpp.macro__end_atom_">Macro
- <code class="computeroutput">end_atom</code></a></dt>
-</dl></dd>
<dt><a href="reference/transaction_bookkeeping_hpp.html">
 Header <code class="computeroutput"><boost/stm/transaction_bookkeeping.hpp></code></a></dt>
<dd><dl><dt><a href="reference/transaction_bookkeeping_hpp.html#toward_boost_stm.reference.transaction_bookkeeping_hpp.class__transaction_bookkeeping_">Class
@@ -145,7 +150,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="users_guide/glosary.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="reference/data_types_hpp.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="users_guide/glosary.html"><img src="../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.html"><img src="../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="reference/base_contention_manager_hpp.html"><img src="../../../../../doc/html/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/base_contention_manager_hpp.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/base_contention_manager_hpp.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/base_contention_manager_hpp.html 2009-09-22 14:14:13 EDT (Tue, 22 Sep 2009)
@@ -6,8 +6,8 @@
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../reference.html" title="Reference">
-<link rel="prev" href="non_tx_smart_ptr_hpp.html" title="Header <boost/stm/non_tx_smart_ptr.hpp>">
-<link rel="next" href="language_like_hpp.html" title="Header <boost/stm/language_like.hpp>">
+<link rel="prev" href="../reference.html" title="Reference">
+<link rel="next" href="base_transaction_object_hpp.html" title="Header <boost/stm/base_transaction_object.hpp>">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -20,7 +20,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="non_tx_smart_ptr_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="language_like_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="../reference.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="base_transaction_object_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
@@ -281,7 +281,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="non_tx_smart_ptr_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="language_like_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="../reference.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="base_transaction_object_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/base_transaction_hpp.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/base_transaction_hpp.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/base_transaction_hpp.html 2009-09-22 14:14:13 EDT (Tue, 22 Sep 2009)
@@ -6,8 +6,8 @@
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../reference.html" title="Reference">
-<link rel="prev" href="transaction_hpp.html" title="Header <boost/stm/transaction.hpp>">
-<link rel="next" href="transactional_object_hpp.html" title="Header <boost/stm/transactional_object.hpp>">
+<link rel="prev" href="base_transaction_object_hpp.html" title="Header <boost/stm/base_transaction_object.hpp>">
+<link rel="next" href="data_types_hpp.html" title="Header <boost/stm/data_types.hpp>">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -20,7 +20,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="transaction_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="transactional_object_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="base_transaction_object_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="data_types_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
@@ -28,26 +28,6 @@
 <code class="computeroutput"><boost/stm/base_transaction.hpp></code></a>
</h3></div></div></div>
<div class="toc"><dl>
-<dt><a href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_">Abstract
- Class <code class="computeroutput">base_transaction_object</code></a></dt>
-<dd><dl>
-<dt><a href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_.constructor__base_transaction_object___">Constructor
- <code class="computeroutput">base_transaction_object()</code></a></dt>
-<dt><a href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_.virtual_destructor___base_transaction_object___">Virtual
- Destructor <code class="computeroutput">~base_transaction_object()</code></a></dt>
-<dt><a href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_.virtual_function__copy_state___">Virtual
- function <code class="computeroutput">copy_state()</code></a></dt>
-<dt><a href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_.virtual_function__move_state___">Virtual
- function <code class="computeroutput">move_state()</code></a></dt>
-<dt><a href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_.static_function__retrieve_mem___">Static
- function <code class="computeroutput">retrieve_mem()</code></a></dt>
-<dt><a href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_.static_function__return_mem___">Static
- function <code class="computeroutput">return_mem()</code></a></dt>
-<dt><a href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_.static_function__alloc_size___">Static
- function <code class="computeroutput">alloc_size()</code></a></dt>
-<dt><a href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_.virtual_function__cache_deallocate___">Virtual
- function <code class="computeroutput">cache_deallocate()</code></a></dt>
-</dl></dd>
<dt><a href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.template_function__cache_clone_____">Template
 Function <code class="computeroutput">cache_clone<>()</code></a></dt>
<dt><a href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.template_function__cache_copy_____">Template
@@ -58,24 +38,8 @@
 Function <code class="computeroutput">cache_allocate<>()</code></a></dt>
<dt><a href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.template_function__cache_deallocate_____">Template
 Function <code class="computeroutput">cache_deallocate<>()</code></a></dt>
-<dt><a href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.template_class__transaction_object___">Template
- Class <code class="computeroutput">transaction_object<></code></a></dt>
-<dd><dl>
-<dt><a href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.template_class__transaction_object___.virtual_function__clone___">Virtual
- function <code class="computeroutput">clone()</code></a></dt>
-<dt><a href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.template_class__transaction_object___.virtual_function__copy_state___">Virtual
- function <code class="computeroutput">copy_state()</code></a></dt>
-<dt><a href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.template_class__transaction_object___.virtual_function__move_state___">Virtual
- function <code class="computeroutput">move_state()</code></a></dt>
-<dt><a href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.template_class__transaction_object___.virtual_function__cache_deallocate___">Virtual
- function <code class="computeroutput">cache_deallocate()</code></a></dt>
-</dl></dd>
-<dt><a href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.template_class__native_trans___">Template
- Class <code class="computeroutput">native_trans<></code></a></dt>
</dl></div>
<pre class="programlisting">namespace boost { namespace stm {
- class base_transaction_object;
-
 template <class T> T* cache_clone(const T& val);
 template <class T> void cache_copy(const T* const ori, T* target);
 void cache_release(base_transaction_object* ptr);
@@ -83,243 +47,10 @@
 template <class T> T* cache_allocate();
 template <class T> void cache_deallocate(T*);

-
- template <class Derived> class transaction_object;
- template <typename T> class native_trans;
}}
</pre>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_"></a><a class="link" href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_" title="Abstract Class base_transaction_object">Abstract
- Class <code class="computeroutput">base_transaction_object</code></a>
-</h4></div></div></div>
-<div class="toc"><dl>
-<dt><a href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_.constructor__base_transaction_object___">Constructor
- <code class="computeroutput">base_transaction_object()</code></a></dt>
-<dt><a href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_.virtual_destructor___base_transaction_object___">Virtual
- Destructor <code class="computeroutput">~base_transaction_object()</code></a></dt>
-<dt><a href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_.virtual_function__copy_state___">Virtual
- function <code class="computeroutput">copy_state()</code></a></dt>
-<dt><a href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_.virtual_function__move_state___">Virtual
- function <code class="computeroutput">move_state()</code></a></dt>
-<dt><a href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_.static_function__retrieve_mem___">Static
- function <code class="computeroutput">retrieve_mem()</code></a></dt>
-<dt><a href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_.static_function__return_mem___">Static
- function <code class="computeroutput">return_mem()</code></a></dt>
-<dt><a href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_.static_function__alloc_size___">Static
- function <code class="computeroutput">alloc_size()</code></a></dt>
-<dt><a href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_.virtual_function__cache_deallocate___">Virtual
- function <code class="computeroutput">cache_deallocate()</code></a></dt>
-</dl></div>
-
- This is the base class of all the transactional objects. It tracks:
- 
-<div class="itemizedlist"><ul type="disc">
-<li>
-<code class="computeroutput">transactionThread_</code>: the
- thread identifier holding the write acces to this transactional object
- </li>
-<li>
-<code class="computeroutput">transaction_</code>: the pointer
- to the transaction
- </li>
-<li>
-<code class="computeroutput">version_</code>: the version
- when performing validation
- </li>
-<li>
-<code class="computeroutput">newMemory_</code>: states whether
- this object is a new object
- </li>
-</ul></div>
-
- Transactional objets must specialize the pure virtual functions
- 
-<div class="itemizedlist"><ul type="disc">
-<li><code class="computeroutput">copy_state(base_transaction_object const
- * const
- rhs)</code></li>
-<li>
-<code class="computeroutput">move_state(base_transaction_object *
- rhs)</code>
- if <code class="computeroutput">BUILD_MOVE_SEMANTICS</code>
-</li>
-<li>
-<code class="computeroutput">cache_deallocate()</code>
- if <code class="computeroutput">BOOST_STM_USE_UNASIGNED_COPY</code>
-</li>
-</ul></div>
-
- <code class="computeroutput">copy_state</code> is used to copy
- the backup/working copy to the shared transactional object when the roolback/commit
- is done direct/defered policy is used.
- 
-
- <code class="computeroutput">move_state</code> is used to move
- the backup/working copy to the shared transactional object when the roolback/commit
- is done direct/defered policy is used.
- 
-
- <code class="computeroutput">cache_deallocate</code> is used
- to release the backup/working copy when the transaction ends if direct/defered
- policy is used.
- 
-
- When USE_STM_MEMORY_MANAGER is defined this class provides two functions
- (<code class="computeroutput">retrieve_mem</code> and <code class="computeroutput">return_mem</code>) and to manage a pool of memory.
- 
-<pre class="programlisting">class base_transaction_object
-{
-public:
-
- base_transaction_object();
- virtual ~base_transaction_object() {};
-
- virtual base_transaction_object* clone() const = 0;
- virtual void copy_state(base_transaction_object const * const rhs) = 0;
- virtual void move_state(base_transaction_object * rhs) = 0;
-
- void transaction_thread(thread_id rhs) const;
- thread_id transaction_thread() const;
-
- void new_memory(bool rhs)
- bool new_memory() const;
-
-#if BOOST_STM_PERFORMING_VALIDATION
- void version(std::size_t rhs);
- std::size_t version() const;
-#endif
-
-#if BOOST_STM_USE_MEMORY_MANAGER
- static void return_mem(void *mem, size_t size);
- static void* retrieve_mem(size_t size);
- static void alloc_size(size_t size);
-#endif
-
-#ifdef BOOST_STM_USE_UNASIGNED_COPY
- virtual void cache_deallocate()=0;
-#endif
-
-};
-</pre>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_.constructor__base_transaction_object___"></a><a class="link" href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_.constructor__base_transaction_object___" title="Constructor base_transaction_object()">Constructor
- <code class="computeroutput">base_transaction_object()</code></a>
-</h5></div></div></div>
-<pre class="programlisting">base_transaction_object();
-</pre>
-
- Default constructor (ctor) with no parameters allows derived base_transaction_objects
- to implicitly construct the base_transaction_object base class for easier
- integration.
- 
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_.virtual_destructor___base_transaction_object___"></a><a class="link" href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_.virtual_destructor___base_transaction_object___" title="Virtual Destructor ~base_transaction_object()">Virtual
- Destructor <code class="computeroutput">~base_transaction_object()</code></a>
-</h5></div></div></div>
-<pre class="programlisting">virtual ~base_transaction_object() {};
-</pre>
-
- Virtual destructor (dtor) ensures correct destructors are called in the
- inheritance hierarchy for delete operations invoked on base_transaction_object
- pointers, which occur in numerous places throughout the internal transaction
- code.
- 
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_.virtual_function__copy_state___"></a><a class="link" href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_.virtual_function__copy_state___" title="Virtual function copy_state()">Virtual
- function <code class="computeroutput">copy_state()</code></a>
-</h5></div></div></div>
-<pre class="programlisting">virtual void copy_state(base_transaction_object const * const rhs) = 0;
-</pre>
-
- The <code class="computeroutput">copy_state()</code>
- method is called each time global memory is updated, for either direct
- or deferred updating policies. With this in mind, it is vital that the
- this object be set to the exact state of the input parameter.
- 
-
- Derived classes usually simply override this method and perform an <code class="computeroutput">operator=()</code>
- function call for the specific derived type.
- 
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_.virtual_function__move_state___"></a><a class="link" href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_.virtual_function__move_state___" title="Virtual function move_state()">Virtual
- function <code class="computeroutput">move_state()</code></a>
-</h5></div></div></div>
-<pre class="programlisting">virtual void move_state(base_transaction_object * rhs) = 0;
-</pre>
-
- The move_state() method is internally called at deferred updating commit
- time and at direct updating abort time and invokes the user-defined derived
- transaction class's move assignment (e.g. operator=(type &&)).
- 
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_.static_function__retrieve_mem___"></a><a class="link" href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_.static_function__retrieve_mem___" title="Static function retrieve_mem()">Static
- function <code class="computeroutput">retrieve_mem()</code></a>
-</h5></div></div></div>
-<pre class="programlisting">static void* retrieve_mem(size_t size);
-</pre>
-
- Static interface into TBoost.STM's memory management system for retrieving
- memory. The supplied parameter is the requested block size, the return
- parameter is a void* to the allocated block. Usually access to this interface
- is done by overloading operator new in the derived base_transaction_object
- class. Void pointers are the natural and preferred manner to handle memory
- allocations and deallocations and are therefore safe in this context.
- 
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_.static_function__return_mem___"></a><a class="link" href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_.static_function__return_mem___" title="Static function return_mem()">Static
- function <code class="computeroutput">return_mem()</code></a>
-</h5></div></div></div>
-<pre class="programlisting">static void return_mem(void *mem, size_t size);
-</pre>
-
- Static interface into TBoost.STM's memory management system for returning
- memory. The first parameter points to the memory block being returned,
- the second parameter specifies its size. Usually access to this interface
- is done by overloading operator delete in the derived transaction object
- class. Void pointers are the natural and preferred manner to handle memory
- allocations and deallocations and are therefore safe in this context.
- 
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_.static_function__alloc_size___"></a><a class="link" href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_.static_function__alloc_size___" title="Static function alloc_size()">Static
- function <code class="computeroutput">alloc_size()</code></a>
-</h5></div></div></div>
-<pre class="programlisting">static void alloc_size(size_t size);
-</pre>
-
- Static interface into TBoost.STM's memory management system which allows
- the user to specify the allocation chunk size for the memory manager.
- The input parameter specifies the number of transactional objects that
- should be allocated at startup and with each subsequent buffer increase.
- If no size is specified, the allocation chunk size uses TBoost.STM's
- default value, currently 8192. The alloc_size() interface can be reconfigured
- at runtime and is used upon the next buffer increase.
- 
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_.virtual_function__cache_deallocate___"></a><a class="link" href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.abstract_class__base_transaction_object_.virtual_function__cache_deallocate___" title="Virtual function cache_deallocate()">Virtual
- function <code class="computeroutput">cache_deallocate()</code></a>
-</h5></div></div></div>
-<pre class="programlisting">virtual void cache_deallocate()=0;
-</pre>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h4 class="title">
<a name="toward_boost_stm.reference.base_transaction_hpp.template_function__cache_clone_____"></a><a class="link" href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.template_function__cache_clone_____" title="Template Function cache_clone<>()">Template
 Function <code class="computeroutput">cache_clone<>()</code></a>
</h4></div></div></div>
@@ -409,122 +140,6 @@
 or the no-op.
 
</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.base_transaction_hpp.template_class__transaction_object___"></a><a class="link" href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.template_class__transaction_object___" title="Template Class transaction_object<>">Template
- Class <code class="computeroutput">transaction_object<></code></a>
-</h4></div></div></div>
-<div class="toc"><dl>
-<dt><a href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.template_class__transaction_object___.virtual_function__clone___">Virtual
- function <code class="computeroutput">clone()</code></a></dt>
-<dt><a href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.template_class__transaction_object___.virtual_function__copy_state___">Virtual
- function <code class="computeroutput">copy_state()</code></a></dt>
-<dt><a href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.template_class__transaction_object___.virtual_function__move_state___">Virtual
- function <code class="computeroutput">move_state()</code></a></dt>
-<dt><a href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.template_class__transaction_object___.virtual_function__cache_deallocate___">Virtual
- function <code class="computeroutput">cache_deallocate()</code></a></dt>
-</dl></div>
-
- To further simplify the usage of TBoost.STM, an intermediate template class
- was built which is meant to sit between the base_transaction_object and
- the user-defined transaction objects. The purpose of this intermediate
- class is to reduce the code overhead needed for user-defined transaction
- objects. To do this, the curiously recurring template pattern developed
- by James Coplien was used.
- 
-
- With the templatized transaction_object, client-side transaction objects
- need only to derive from it and pass their class type as its template parameter.
- At compile-time the transaction_object generates the necessary code to
- override copy_state() and implement operator new and operator delete using
- TBoost.STM's memory manager for all user-defined types derived from it.
- 
-<pre class="programlisting">template <class Derived>
-class transaction_object : public base_transaction_object {
-public:
-
- virtual base_transaction_object* clone() const;
- virtual void copy_state(base_transaction_object const * const rhs);
- virtual void move_state(base_transaction_object * rhs);
-};
-</pre>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.base_transaction_hpp.template_class__transaction_object___.virtual_function__clone___"></a><a class="link" href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.template_class__transaction_object___.virtual_function__clone___" title="Virtual function clone()">Virtual
- function <code class="computeroutput">clone()</code></a>
-</h5></div></div></div>
-<pre class="programlisting">virtual base_transaction_object* clone() const;
-</pre>
-
- The clone() method calls to the free function cache_new_copy which allocates
- enough memory for the new object and then do a memcpy by default.
- 
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.base_transaction_hpp.template_class__transaction_object___.virtual_function__copy_state___"></a><a class="link" href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.template_class__transaction_object___.virtual_function__copy_state___" title="Virtual function copy_state()">Virtual
- function <code class="computeroutput">copy_state()</code></a>
-</h5></div></div></div>
-<pre class="programlisting">virtual void copy_state(base_transaction_object const * const rhs);
-</pre>
-
- The copy_state() method call to the free function cache_copy which do
- a memcpy by default.
- 
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.base_transaction_hpp.template_class__transaction_object___.virtual_function__move_state___"></a><a class="link" href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.template_class__transaction_object___.virtual_function__move_state___" title="Virtual function move_state()">Virtual
- function <code class="computeroutput">move_state()</code></a>
-</h5></div></div></div>
-<pre class="programlisting">virtual void move_state(base_transaction_object * rhs);
-</pre>
-
- The move_state() method call to the free function cache_copy which do
- a memcpy by default.
- 
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.base_transaction_hpp.template_class__transaction_object___.virtual_function__cache_deallocate___"></a><a class="link" href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.template_class__transaction_object___.virtual_function__cache_deallocate___" title="Virtual function cache_deallocate()">Virtual
- function <code class="computeroutput">cache_deallocate()</code></a>
-</h5></div></div></div>
-<pre class="programlisting">virtual void cache_deallocate();
-</pre>
-
- The cache_deallocate() method call to the free function cache_deallocate
- which do a memcpy by default.
- 
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.base_transaction_hpp.template_class__native_trans___"></a><a class="link" href="base_transaction_hpp.html#toward_boost_stm.reference.base_transaction_hpp.template_class__native_trans___" title="Template Class native_trans<>">Template
- Class <code class="computeroutput">native_trans<></code></a>
-</h4></div></div></div>
-<pre class="programlisting">template <typename T> class native_trans : public transaction_object< native_trans<T> > {
-public:
- native_trans(){}
- native_trans(T const &rhs);
- native_trans(native_trans const &rhs);
- native_trans(native_trans &&rhs);
- native_trans& operator=(native_trans &&rhs);
-
- native_trans& operator=(T const &rhs);
-
- native_trans& operator--();
- native_trans operator--(int);
- native_trans& operator++();
- native_trans operator++(int);
- native_trans& operator+=(T const &rhs);
- native_trans operator+(native_trans const &rhs);
-
- operator T() const;
- T& value();
- T const & value() const;
-};
-</pre>
-</div>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
@@ -536,7 +151,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="transaction_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="transactional_object_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="base_transaction_object_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="data_types_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Added: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/base_transaction_object_hpp.html
==============================================================================
--- (empty file)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/base_transaction_object_hpp.html 2009-09-22 14:14:13 EDT (Tue, 22 Sep 2009)
@@ -0,0 +1,300 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Header <boost/stm/base_transaction_object.hpp></title>
+<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
+<link rel="up" href="../reference.html" title="Reference">
+<link rel="prev" href="base_contention_manager_hpp.html" title="Header <boost/stm/base_contention_manager.hpp>">
+<link rel="next" href="cache_fct_hpp.html" title="Header <boost/stm/cache_fct.hpp>">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="TowardBoostSTM" width="277" height="86" src="../../../image/Toward_Boost_STM.jpg"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="base_contention_manager_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="cache_fct_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="toward_boost_stm.reference.base_transaction_object_hpp"></a><a class="link" href="base_transaction_object_hpp.html" title="Header <boost/stm/base_transaction_object.hpp>">
+ Header <code class="computeroutput"><boost/stm/base_transaction_object.hpp></code></a>
+</h3></div></div></div>
+<div class="toc"><dl>
+<dt><a href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_">Abstract
+ Class <code class="computeroutput">base_transaction_object</code></a></dt>
+<dd><dl>
+<dt><a href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.constructor__base_transaction_object___">Constructor
+ <code class="computeroutput">base_transaction_object()</code></a></dt>
+<dt><a href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.virtual_destructor___base_transaction_object___">Virtual
+ Destructor <code class="computeroutput">~base_transaction_object()</code></a></dt>
+<dt><a href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__copy_state___">Virtual
+ function <code class="computeroutput">copy_state()</code></a></dt>
+<dt><a href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__move_state___">Virtual
+ function <code class="computeroutput">move_state()</code></a></dt>
+<dt><a href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.static_function__retrieve_mem___">Static
+ function <code class="computeroutput">retrieve_mem()</code></a></dt>
+<dt><a href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.static_function__return_mem___">Static
+ function <code class="computeroutput">return_mem()</code></a></dt>
+<dt><a href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.static_function__alloc_size___">Static
+ function <code class="computeroutput">alloc_size()</code></a></dt>
+<dt><a href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__cache_deallocate___">Virtual
+ function <code class="computeroutput">cache_deallocate()</code></a></dt>
+</dl></dd>
+</dl></div>
+<pre class="programlisting">namespace boost { namespace stm {
+ class base_transaction_object;
+}}
+</pre>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_"></a><a class="link" href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_" title="Abstract Class base_transaction_object">Abstract
+ Class <code class="computeroutput">base_transaction_object</code></a>
+</h4></div></div></div>
+<div class="toc"><dl>
+<dt><a href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.constructor__base_transaction_object___">Constructor
+ <code class="computeroutput">base_transaction_object()</code></a></dt>
+<dt><a href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.virtual_destructor___base_transaction_object___">Virtual
+ Destructor <code class="computeroutput">~base_transaction_object()</code></a></dt>
+<dt><a href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__copy_state___">Virtual
+ function <code class="computeroutput">copy_state()</code></a></dt>
+<dt><a href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__move_state___">Virtual
+ function <code class="computeroutput">move_state()</code></a></dt>
+<dt><a href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.static_function__retrieve_mem___">Static
+ function <code class="computeroutput">retrieve_mem()</code></a></dt>
+<dt><a href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.static_function__return_mem___">Static
+ function <code class="computeroutput">return_mem()</code></a></dt>
+<dt><a href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.static_function__alloc_size___">Static
+ function <code class="computeroutput">alloc_size()</code></a></dt>
+<dt><a href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__cache_deallocate___">Virtual
+ function <code class="computeroutput">cache_deallocate()</code></a></dt>
+</dl></div>
+
+ This is the base class of all the transactional objects. It tracks:
+ 
+<div class="itemizedlist"><ul type="disc">
+<li>
+<code class="computeroutput">transactionThread_</code>: the
+ thread identifier holding the write acces to this transactional object
+ </li>
+<li>
+<code class="computeroutput">transaction_</code>: the pointer
+ to the transaction
+ </li>
+<li>
+<code class="computeroutput">version_</code>: the version
+ when performing validation
+ </li>
+<li>
+<code class="computeroutput">newMemory_</code>: states whether
+ this object is a new object
+ </li>
+</ul></div>
+
+ Transactional objets must specialize the pure virtual functions
+ 
+<div class="itemizedlist"><ul type="disc">
+<li><code class="computeroutput">copy_state(base_transaction_object const
+ * const
+ rhs)</code></li>
+<li>
+<code class="computeroutput">move_state(base_transaction_object *
+ rhs)</code>
+ if <code class="computeroutput">BUILD_MOVE_SEMANTICS</code>
+</li>
+<li>
+<code class="computeroutput">cache_deallocate()</code>
+ if <code class="computeroutput">BOOST_STM_USE_UNASIGNED_COPY</code>
+</li>
+</ul></div>
+
+ <code class="computeroutput">copy_state</code> is used to copy
+ the backup/working copy to the shared transactional object when the roolback/commit
+ is done direct/defered policy is used.
+ 
+
+ <code class="computeroutput">move_state</code> is used to move
+ the backup/working copy to the shared transactional object when the roolback/commit
+ is done direct/defered policy is used.
+ 
+
+ <code class="computeroutput">cache_deallocate</code> is used
+ to release the backup/working copy when the transaction ends if direct/defered
+ policy is used.
+ 
+
+ When USE_STM_MEMORY_MANAGER is defined this class provides two functions
+ (<code class="computeroutput">retrieve_mem</code> and <code class="computeroutput">return_mem</code>) and to manage a pool of memory.
+ 
+<pre class="programlisting">class base_transaction_object
+{
+public:
+
+ base_transaction_object();
+ virtual ~base_transaction_object() {};
+
+ virtual base_transaction_object* clone() const = 0;
+ virtual void copy_state(base_transaction_object const * const rhs) = 0;
+ virtual void move_state(base_transaction_object * rhs) = 0;
+
+ void transaction_thread(thread_id rhs) const;
+ thread_id transaction_thread() const;
+
+ void new_memory(bool rhs)
+ bool new_memory() const;
+
+#if BOOST_STM_PERFORMING_VALIDATION
+ void version(std::size_t rhs);
+ std::size_t version() const;
+#endif
+
+#if BOOST_STM_USE_MEMORY_MANAGER
+ static void return_mem(void *mem, size_t size);
+ static void* retrieve_mem(size_t size);
+ static void alloc_size(size_t size);
+#endif
+
+#ifdef BOOST_STM_USE_UNASIGNED_COPY
+ virtual void cache_deallocate()=0;
+#endif
+
+};
+</pre>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.constructor__base_transaction_object___"></a><a class="link" href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.constructor__base_transaction_object___" title="Constructor base_transaction_object()">Constructor
+ <code class="computeroutput">base_transaction_object()</code></a>
+</h5></div></div></div>
+<pre class="programlisting">base_transaction_object();
+</pre>
+
+ Default constructor (ctor) with no parameters allows derived base_transaction_objects
+ to implicitly construct the base_transaction_object base class for easier
+ integration.
+ 
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.virtual_destructor___base_transaction_object___"></a><a class="link" href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.virtual_destructor___base_transaction_object___" title="Virtual Destructor ~base_transaction_object()">Virtual
+ Destructor <code class="computeroutput">~base_transaction_object()</code></a>
+</h5></div></div></div>
+<pre class="programlisting">virtual ~base_transaction_object() {};
+</pre>
+
+ Virtual destructor (dtor) ensures correct destructors are called in the
+ inheritance hierarchy for delete operations invoked on base_transaction_object
+ pointers, which occur in numerous places throughout the internal transaction
+ code.
+ 
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__copy_state___"></a><a class="link" href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__copy_state___" title="Virtual function copy_state()">Virtual
+ function <code class="computeroutput">copy_state()</code></a>
+</h5></div></div></div>
+<pre class="programlisting">virtual void copy_state(base_transaction_object const * const rhs) = 0;
+</pre>
+
+ The <code class="computeroutput">copy_state()</code>
+ method is called each time global memory is updated, for either direct
+ or deferred updating policies. With this in mind, it is vital that the
+ this object be set to the exact state of the input parameter.
+ 
+
+ Derived classes usually simply override this method and perform an <code class="computeroutput">operator=()</code>
+ function call for the specific derived type.
+ 
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__move_state___"></a><a class="link" href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__move_state___" title="Virtual function move_state()">Virtual
+ function <code class="computeroutput">move_state()</code></a>
+</h5></div></div></div>
+<pre class="programlisting">virtual void move_state(base_transaction_object * rhs) = 0;
+</pre>
+
+ The move_state() method is internally called at deferred updating commit
+ time and at direct updating abort time and invokes the user-defined derived
+ transaction class's move assignment (e.g. operator=(type &&)).
+ 
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.static_function__retrieve_mem___"></a><a class="link" href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.static_function__retrieve_mem___" title="Static function retrieve_mem()">Static
+ function <code class="computeroutput">retrieve_mem()</code></a>
+</h5></div></div></div>
+<pre class="programlisting">static void* retrieve_mem(size_t size);
+</pre>
+
+ Static interface into TBoost.STM's memory management system for retrieving
+ memory. The supplied parameter is the requested block size, the return
+ parameter is a void* to the allocated block. Usually access to this interface
+ is done by overloading operator new in the derived base_transaction_object
+ class. Void pointers are the natural and preferred manner to handle memory
+ allocations and deallocations and are therefore safe in this context.
+ 
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.static_function__return_mem___"></a><a class="link" href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.static_function__return_mem___" title="Static function return_mem()">Static
+ function <code class="computeroutput">return_mem()</code></a>
+</h5></div></div></div>
+<pre class="programlisting">static void return_mem(void *mem, size_t size);
+</pre>
+
+ Static interface into TBoost.STM's memory management system for returning
+ memory. The first parameter points to the memory block being returned,
+ the second parameter specifies its size. Usually access to this interface
+ is done by overloading operator delete in the derived transaction object
+ class. Void pointers are the natural and preferred manner to handle memory
+ allocations and deallocations and are therefore safe in this context.
+ 
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.static_function__alloc_size___"></a><a class="link" href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.static_function__alloc_size___" title="Static function alloc_size()">Static
+ function <code class="computeroutput">alloc_size()</code></a>
+</h5></div></div></div>
+<pre class="programlisting">static void alloc_size(size_t size);
+</pre>
+
+ Static interface into TBoost.STM's memory management system which allows
+ the user to specify the allocation chunk size for the memory manager.
+ The input parameter specifies the number of transactional objects that
+ should be allocated at startup and with each subsequent buffer increase.
+ If no size is specified, the allocation chunk size uses TBoost.STM's
+ default value, currently 8192. The alloc_size() interface can be reconfigured
+ at runtime and is used upon the next buffer increase.
+ 
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h5 class="title">
+<a name="toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__cache_deallocate___"></a><a class="link" href="base_transaction_object_hpp.html#toward_boost_stm.reference.base_transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__cache_deallocate___" title="Virtual function cache_deallocate()">Virtual
+ function <code class="computeroutput">cache_deallocate()</code></a>
+</h5></div></div></div>
+<pre class="programlisting">virtual void cache_deallocate()=0;
+</pre>
+</div>
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2009 Justin E. Gottchlich Copyright © 2009 Vicente J. Botet Escriba
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="base_contention_manager_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="cache_fct_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Added: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/cache_fct_hpp.html
==============================================================================
--- (empty file)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/cache_fct_hpp.html 2009-09-22 14:14:13 EDT (Tue, 22 Sep 2009)
@@ -0,0 +1,156 @@
+<html>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+<title>Header <boost/stm/cache_fct.hpp></title>
+<link rel="stylesheet" href="../../../../../../doc/html/boostbook.css" type="text/css">
+<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
+<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
+<link rel="up" href="../reference.html" title="Reference">
+<link rel="prev" href="base_transaction_object_hpp.html" title="Header <boost/stm/base_transaction_object.hpp>">
+<link rel="next" href="data_types_hpp.html" title="Header <boost/stm/data_types.hpp>">
+</head>
+<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
+<table cellpadding="2" width="100%"><tr>
+<td valign="top"><img alt="TowardBoostSTM" width="277" height="86" src="../../../image/Toward_Boost_STM.jpg"></td>
+<td align="center">Home</td>
+<td align="center">Libraries</td>
+<td align="center">People</td>
+<td align="center">FAQ</td>
+<td align="center">More</td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="base_transaction_object_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="data_types_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h3 class="title">
+<a name="toward_boost_stm.reference.cache_fct_hpp"></a><a class="link" href="cache_fct_hpp.html" title="Header <boost/stm/cache_fct.hpp>"> Header <code class="computeroutput"><boost/stm/cache_fct.hpp></code></a>
+</h3></div></div></div>
+<div class="toc"><dl>
+<dt><a href="cache_fct_hpp.html#toward_boost_stm.reference.cache_fct_hpp.template_function__cache_clone_____">Template
+ Function <code class="computeroutput">cache_clone<>()</code></a></dt>
+<dt><a href="cache_fct_hpp.html#toward_boost_stm.reference.cache_fct_hpp.template_function__cache_copy_____">Template
+ Function <code class="computeroutput">cache_copy<>()</code></a></dt>
+<dt><a href="cache_fct_hpp.html#toward_boost_stm.reference.cache_fct_hpp.function__cache_release_____">Function
+ <code class="computeroutput">cache_release<>()</code></a></dt>
+<dt><a href="cache_fct_hpp.html#toward_boost_stm.reference.cache_fct_hpp.template_function__cache_allocate_____">Template
+ Function <code class="computeroutput">cache_allocate<>()</code></a></dt>
+<dt><a href="cache_fct_hpp.html#toward_boost_stm.reference.cache_fct_hpp.template_function__cache_deallocate_____">Template
+ Function <code class="computeroutput">cache_deallocate<>()</code></a></dt>
+</dl></div>
+<pre class="programlisting">namespace boost { namespace stm {
+ template <class T> T* cache_clone(const T& val);
+ template <class T> void cache_copy(const T* const ori, T* target);
+ void cache_release(base_transaction_object* ptr);
+
+ template <class T> T* cache_allocate();
+ template <class T> void cache_deallocate(T*);
+
+}}
+</pre>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="toward_boost_stm.reference.cache_fct_hpp.template_function__cache_clone_____"></a><a class="link" href="cache_fct_hpp.html#toward_boost_stm.reference.cache_fct_hpp.template_function__cache_clone_____" title="Template Function cache_clone<>()">Template
+ Function <code class="computeroutput">cache_clone<>()</code></a>
+</h4></div></div></div>
+<pre class="programlisting">template <class T>
+T* cache_clone(const T& val);
+</pre>
+
+ Makes a new copy of the parameter. Allocates an object of type T using
+ the <code class="computeroutput">cache_allocate</code> function
+ and copy from the given parameter <code class="computeroutput">val</code>
+ using the free function <code class="computeroutput">cache_copy</code>.
+ 
+
+ The user can overload this function, as TBoost.STM uses ADL to access it.
+ 
+
+ When <code class="computeroutput">BOOST_STM_NO_PARTIAL_SPECIALIZATION</code>
+ is defined, i.e. on compilers not supporting partial template specialization,
+ the function calls to <code class="computeroutput">partial_specialization_workaround::cache_clone<T>::apply(val)</code>. So the user will need to overload the
+ class <code class="computeroutput">partial_specialization_workaround::cache_clone<T></code> defining the function
+ 
+<pre class="programlisting">static T* apply(const T& val);
+</pre>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="toward_boost_stm.reference.cache_fct_hpp.template_function__cache_copy_____"></a><a class="link" href="cache_fct_hpp.html#toward_boost_stm.reference.cache_fct_hpp.template_function__cache_copy_____" title="Template Function cache_copy<>()">Template
+ Function <code class="computeroutput">cache_copy<>()</code></a>
+</h4></div></div></div>
+<pre class="programlisting">template <class T>
+void cache_copy(const T* const source, T* target);
+</pre>
+
+ Copy from souce to target using memcpy by default.
+ 
+
+ The user can overload this function, as TBoost.STM uses ADL to access it.
+ 
+
+ When <code class="computeroutput">BOOST_STM_NO_PARTIAL_SPECIALIZATION</code>
+ is defined, i.e. on compilers not supporting partial template specialization,
+ the function calls to <code class="computeroutput">partial_specialization_workaround::cache_copy<T>::apply(source, target)</code>. So the user will need to overload the
+ class <code class="computeroutput">partial_specialization_workaround::cache_copy<T></code> defining the function
+ 
+<pre class="programlisting">static T* apply(const T* const source, T* target);
+</pre>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="toward_boost_stm.reference.cache_fct_hpp.function__cache_release_____"></a><a class="link" href="cache_fct_hpp.html#toward_boost_stm.reference.cache_fct_hpp.function__cache_release_____" title="Function cache_release<>()">Function
+ <code class="computeroutput">cache_release<>()</code></a>
+</h4></div></div></div>
+<pre class="programlisting">void cache_release(base_transaction_object* ptr) {
+</pre>
+
+ Release the given base_transaction_object by calling to the virtual function
+ <code class="computeroutput">cache_dealocate</code>.
+ 
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="toward_boost_stm.reference.cache_fct_hpp.template_function__cache_allocate_____"></a><a class="link" href="cache_fct_hpp.html#toward_boost_stm.reference.cache_fct_hpp.template_function__cache_allocate_____" title="Template Function cache_allocate<>()">Template
+ Function <code class="computeroutput">cache_allocate<>()</code></a>
+</h4></div></div></div>
+<pre class="programlisting">template <class T>
+T* cache_allocate();
+</pre>
+
+ Allocates an instance of calls T. Depending on whether BOOST_STM_CACHE_USE_MEMORY_MANAGER,
+ BOOST_STM_CACHE_USE_MALLOC or BOOST_STM_CACHE_USE_TSS_MONOTONIC_MEMORY_MANAGER
+ are defined this function will use the static pool of the class T, malloc
+ or the thread specific monotonic allocator.
+ 
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
+<a name="toward_boost_stm.reference.cache_fct_hpp.template_function__cache_deallocate_____"></a><a class="link" href="cache_fct_hpp.html#toward_boost_stm.reference.cache_fct_hpp.template_function__cache_deallocate_____" title="Template Function cache_deallocate<>()">Template
+ Function <code class="computeroutput">cache_deallocate<>()</code></a>
+</h4></div></div></div>
+<pre class="programlisting">template <class T>
+void cache_deallocate(T*ptr) {
+</pre>
+
+ Deallocates an instance of calls T. Depending on whether BOOST_STM_CACHE_USE_MEMORY_MANAGER,
+ BOOST_STM_CACHE_USE_MALLOC or BOOST_STM_CACHE_USE_TSS_MONOTONIC_MEMORY_MANAGER
+ are defined this function will use the static pool of the class T, free
+ or the no-op.
+ 
+</div>
+</div>
+<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
+<td align="left"></td>
+<td align="right"><div class="copyright-footer">Copyright © 2009 Justin E. Gottchlich Copyright © 2009 Vicente J. Botet Escriba
+ Distributed under the Boost Software License, Version 1.0. (See accompanying
+ file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ 
+</div></td>
+</tr></table>
+<hr>
+<div class="spirit-nav">
+<a accesskey="p" href="base_transaction_object_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="data_types_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+</div>
+</body>
+</html>

Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/data_types_hpp.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/data_types_hpp.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/data_types_hpp.html 2009-09-22 14:14:13 EDT (Tue, 22 Sep 2009)
@@ -6,7 +6,7 @@
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../reference.html" title="Reference">
-<link rel="prev" href="../reference.html" title="Reference">
+<link rel="prev" href="cache_fct_hpp.html" title="Header <boost/stm/cache_fct.hpp>">
<link rel="next" href="exceptions_hpp.html" title="Header <boost/stm/exceptions.hpp>">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -20,7 +20,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../reference.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="exceptions_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="cache_fct_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="exceptions_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
@@ -43,14 +43,32 @@
 typedef thread_id_t;
}}
</pre>
-<div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title">
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
<a name="toward_boost_stm.reference.data_types_hpp.enum__transaction_type_"></a><a class="link" href="data_types_hpp.html#toward_boost_stm.reference.data_types_hpp.enum__transaction_type_" title="Enum transaction_type">Enum
 <code class="computeroutput">transaction_type</code></a>
-</h4></div></div></div></div>
-<div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title">
+</h4></div></div></div>
+<pre class="programlisting"> enum transaction_type
+ {
+ eNormalTx,
+ eIrrevocableTx,
+ eIrrevocableAndIsolatedTx
+};
+</pre>
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
<a name="toward_boost_stm.reference.data_types_hpp.enum__latm_type_"></a><a class="link" href="data_types_hpp.html#toward_boost_stm.reference.data_types_hpp.enum__latm_type_" title="Enum latm_type">Enum
 <code class="computeroutput">latm_type</code></a>
-</h4></div></div></div></div>
+</h4></div></div></div>
+<pre class="programlisting">enum latm_type
+{
+ eFullLatmProtection,
+ eTmConflictingLockLatmProtection,
+ eTxConflictingLockLatmProtection
+};
+</pre>
+</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
<a name="toward_boost_stm.reference.data_types_hpp.enum__transaction_state_"></a><a class="link" href="data_types_hpp.html#toward_boost_stm.reference.data_types_hpp.enum__transaction_state_" title="Enum transaction_state">Enum
@@ -66,10 +84,14 @@
};
</pre>
</div>
-<div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title">
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h4 class="title">
<a name="toward_boost_stm.reference.data_types_hpp.typedef__thread_id_t_"></a><a class="link" href="data_types_hpp.html#toward_boost_stm.reference.data_types_hpp.typedef__thread_id_t_" title="Typedef thread_id_t">Typedef
 <code class="computeroutput">thread_id_t</code></a>
-</h4></div></div></div></div>
+</h4></div></div></div>
+<pre class="programlisting">typedef platform_specific thread_id_t;
+</pre>
+</div>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
@@ -81,7 +103,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="../reference.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="exceptions_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="cache_fct_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="exceptions_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/exceptions_hpp.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/exceptions_hpp.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/exceptions_hpp.html 2009-09-22 14:14:13 EDT (Tue, 22 Sep 2009)
@@ -7,7 +7,7 @@
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../reference.html" title="Reference">
<link rel="prev" href="data_types_hpp.html" title="Header <boost/stm/data_types.hpp>">
-<link rel="next" href="transaction_hpp.html" title="Header <boost/stm/transaction.hpp>">
+<link rel="next" href="language_like_hpp.html" title="Header <boost/stm/language_like.hpp>">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -20,7 +20,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="data_types_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="transaction_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="data_types_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="language_like_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
@@ -47,7 +47,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="data_types_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="transaction_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="data_types_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="language_like_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/language_like_hpp.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/language_like_hpp.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/language_like_hpp.html 2009-09-22 14:14:13 EDT (Tue, 22 Sep 2009)
@@ -6,8 +6,8 @@
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../reference.html" title="Reference">
-<link rel="prev" href="base_contention_manager_hpp.html" title="Header <boost/stm/base_contention_manager.hpp>">
-<link rel="next" href="transaction_bookkeeping_hpp.html" title="Header <boost/stm/transaction_bookkeeping.hpp>">
+<link rel="prev" href="exceptions_hpp.html" title="Header <boost/stm/exceptions.hpp>">
+<link rel="next" href="transaction_hpp.html" title="Header <boost/stm/transaction.hpp>">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -20,7 +20,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="base_contention_manager_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="transaction_bookkeeping_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="exceptions_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="transaction_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
@@ -208,7 +208,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="base_contention_manager_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="transaction_bookkeeping_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="exceptions_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="transaction_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/non_tx_smart_ptr_hpp.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/non_tx_smart_ptr_hpp.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/non_tx_smart_ptr_hpp.html 2009-09-22 14:14:13 EDT (Tue, 22 Sep 2009)
@@ -7,7 +7,7 @@
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../reference.html" title="Reference">
<link rel="prev" href="tx_smart_ptr_hpp.html" title="Header <boost/stm/tx_smart_ptr.hpp>">
-<link rel="next" href="base_contention_manager_hpp.html" title="Header <boost/stm/base_contention_manager.hpp>">
+<link rel="next" href="transaction_bookkeeping_hpp.html" title="Header <boost/stm/transaction_bookkeeping.hpp>">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -20,7 +20,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="tx_smart_ptr_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="base_contention_manager_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="tx_smart_ptr_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="transaction_bookkeeping_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
@@ -187,7 +187,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="tx_smart_ptr_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="base_contention_manager_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="tx_smart_ptr_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="transaction_bookkeeping_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/transaction_bookkeeping_hpp.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/transaction_bookkeeping_hpp.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/transaction_bookkeeping_hpp.html 2009-09-22 14:14:13 EDT (Tue, 22 Sep 2009)
@@ -6,7 +6,7 @@
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../reference.html" title="Reference">
-<link rel="prev" href="language_like_hpp.html" title="Header <boost/stm/language_like.hpp>">
+<link rel="prev" href="non_tx_smart_ptr_hpp.html" title="Header <boost/stm/non_tx_smart_ptr.hpp>">
<link rel="next" href="../examples.html" title="Examples">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -20,7 +20,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="language_like_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../examples.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="non_tx_smart_ptr_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../examples.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
@@ -114,7 +114,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="language_like_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../examples.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="non_tx_smart_ptr_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="../examples.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/transaction_hpp.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/transaction_hpp.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/transaction_hpp.html 2009-09-22 14:14:13 EDT (Tue, 22 Sep 2009)
@@ -6,8 +6,8 @@
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../reference.html" title="Reference">
-<link rel="prev" href="exceptions_hpp.html" title="Header <boost/stm/exceptions.hpp>">
-<link rel="next" href="base_transaction_hpp.html" title="Header <boost/stm/base_transaction.hpp>">
+<link rel="prev" href="language_like_hpp.html" title="Header <boost/stm/language_like.hpp>">
+<link rel="next" href="transaction_object_hpp.html" title="Header <boost/stm/transaction_object.hpp>">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -20,7 +20,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="exceptions_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="base_transaction_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="language_like_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="transaction_object_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
@@ -1080,7 +1080,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="exceptions_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="base_transaction_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="language_like_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="transaction_object_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/transaction_object_hpp.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/transaction_object_hpp.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/transaction_object_hpp.html 2009-09-22 14:14:13 EDT (Tue, 22 Sep 2009)
@@ -7,7 +7,7 @@
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../reference.html" title="Reference">
<link rel="prev" href="transaction_hpp.html" title="Header <boost/stm/transaction.hpp>">
-<link rel="next" href="tx_ptr_hpp.html" title="Header <boost/stm/tx_ptr.hpp>">
+<link rel="next" href="transactional_object_hpp.html" title="Header <boost/stm/transactional_object.hpp>">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
@@ -20,7 +20,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="transaction_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="tx_ptr_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="transaction_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="transactional_object_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
@@ -28,29 +28,11 @@
 <code class="computeroutput"><boost/stm/transaction_object.hpp></code></a>
</h3></div></div></div>
<div class="toc"><dl>
-<dt><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_">Abstract
- Class <code class="computeroutput">base_transaction_object</code></a></dt>
-<dd><dl>
-<dt><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_.constructor__base_transaction_object___">Constructor
- <code class="computeroutput">base_transaction_object()</code></a></dt>
-<dt><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_.virtual_destructor___base_transaction_object___">Virtual
- Destructor <code class="computeroutput">~base_transaction_object()</code></a></dt>
-<dt><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__copy_state___">Virtual
- function <code class="computeroutput">copy_state()</code></a></dt>
-<dt><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__move_state___">Virtual
- function <code class="computeroutput">move_state()</code></a></dt>
-<dt><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_.static_function__retrieve_mem___">Static
- function <code class="computeroutput">retrieve_mem()</code></a></dt>
-<dt><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_.static_function__return_mem___">Static
- function <code class="computeroutput">return_mem()</code></a></dt>
-<dt><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_.static_function__alloc_size___">Static
- function <code class="computeroutput">alloc_size()</code></a></dt>
-<dt><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__cache_deallocate___">Virtual
- function <code class="computeroutput">cache_deallocate()</code></a></dt>
-</dl></dd>
<dt><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___">Template
 Class <code class="computeroutput">transaction_object<></code></a></dt>
<dd><dl>
+<dt><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___.virtual_function__clone___">Virtual
+ function <code class="computeroutput">clone()</code></a></dt>
<dt><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___.virtual_function__copy_state___">Virtual
 function <code class="computeroutput">copy_state()</code></a></dt>
<dt><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___.virtual_function__move_state___">Virtual
@@ -60,262 +42,20 @@
</dl></dd>
<dt><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__native_trans___">Template
 Class <code class="computeroutput">native_trans<></code></a></dt>
-<dt><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__transactional_object___">Template
- Class <code class="computeroutput">transactional_object<></code></a></dt>
-<dd><dl>
-<dt><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__transactional_object___.virtual_function__copy_state___">Virtual
- function <code class="computeroutput">copy_state()</code></a></dt>
-<dt><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__transactional_object___.virtual_function__move_state___">Virtual
- function <code class="computeroutput">move_state()</code></a></dt>
-<dt><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__transactional_object___.virtual_function__cache_deallocate___">Virtual
- function <code class="computeroutput">cache_deallocate()</code></a></dt>
-</dl></dd>
</dl></div>
<pre class="programlisting">namespace boost { namespace stm {
- class base_transaction_object;
 template <class Derived> class transaction_object;
 template <typename T> class native_trans;
- template <class T> class transactional_object;
-
- template <typename T>
- static transactional_object<T>* tx_up_cast(T* ptr);
-
- template <typename T, typename U>
- static transactional_object<T>* tx_static_cast(transactional_object<U>* ptr);
-
- template <typename T, typename U>
- static transactional_object<T>* tx_dynamic_cast(transactional_object<U>* ptr);
}}
</pre>
<div class="section" lang="en">
<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_"></a><a class="link" href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_" title="Abstract Class base_transaction_object">Abstract
- Class <code class="computeroutput">base_transaction_object</code></a>
-</h4></div></div></div>
-<div class="toc"><dl>
-<dt><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_.constructor__base_transaction_object___">Constructor
- <code class="computeroutput">base_transaction_object()</code></a></dt>
-<dt><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_.virtual_destructor___base_transaction_object___">Virtual
- Destructor <code class="computeroutput">~base_transaction_object()</code></a></dt>
-<dt><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__copy_state___">Virtual
- function <code class="computeroutput">copy_state()</code></a></dt>
-<dt><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__move_state___">Virtual
- function <code class="computeroutput">move_state()</code></a></dt>
-<dt><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_.static_function__retrieve_mem___">Static
- function <code class="computeroutput">retrieve_mem()</code></a></dt>
-<dt><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_.static_function__return_mem___">Static
- function <code class="computeroutput">return_mem()</code></a></dt>
-<dt><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_.static_function__alloc_size___">Static
- function <code class="computeroutput">alloc_size()</code></a></dt>
-<dt><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__cache_deallocate___">Virtual
- function <code class="computeroutput">cache_deallocate()</code></a></dt>
-</dl></div>
-
- This is the base class of all the transactional objects. It tracks:
- 
-<div class="itemizedlist"><ul type="disc">
-<li>
-<code class="computeroutput">transactionThread_</code>: the
- thread identifier holding the write acces to this transactional object
- </li>
-<li>
-<code class="computeroutput">transaction_</code>: the pointer
- to the transaction
- </li>
-<li>
-<code class="computeroutput">version_</code>: the version
- when performing validation
- </li>
-<li>
-<code class="computeroutput">newMemory_</code>: states whether
- this object is a new object
- </li>
-</ul></div>
-
- Transactional objets must specialize the pure virtual functions * <code class="computeroutput">copy_state(base_transaction_object const
- * const
- rhs)</code>
- * <code class="computeroutput">move_state(base_transaction_object *
- rhs)</code>
- if <code class="computeroutput">BUILD_MOVE_SEMANTICS</code>
- * <code class="computeroutput">cache_deallocate()</code>
- if <code class="computeroutput">BOOST_STM_USE_UNASIGNED_COPY</code>
- 
-
- <code class="computeroutput">copy_state</code> is used to copy
- the backup/working copy to the shared transactional object when the roolback/commit
- is done direct/defered policy is used.
- 
-
- <code class="computeroutput">move_state</code> is used to move
- the backup/working copy to the shared transactional object when the roolback/commit
- is done direct/defered policy is used.
- 
-
- <code class="computeroutput">cache_deallocate</code> is used
- to release the backup/working copy when the transaction ends if direct/defered
- policy is used.
- 
-
- When USE_STM_MEMORY_MANAGER is defined this class provides two functions
- (<code class="computeroutput">retrieve_mem</code> and <code class="computeroutput">return_mem</code>) and to manage a pool of memory.
- 
-<pre class="programlisting">class base_transaction_object
-{
-public:
-
- base_transaction_object();
- virtual ~base_transaction_object() {};
-
- virtual void copy_state(base_transaction_object const * const rhs) = 0;
- virtual void move_state(base_transaction_object * rhs) = 0;
-
- void transaction_thread(thread_id rhs) const;
- thread_id transaction_thread() const;
-
- void new_memory(bool rhs)
- bool new_memory() const;
-
-#if BOOST_STM_PERFORMING_VALIDATION
- void version(std::size_t rhs);
- std::size_t version() const;
-#endif
-
-#if BOOST_STM_USE_MEMORY_MANAGER
- static void return_mem(void *mem, size_t size);
- static void* retrieve_mem(size_t size);
- static void alloc_size(size_t size);
-#endif
-
-#ifdef BOOST_STM_USE_UNASIGNED_COPY
- virtual void cache_deallocate()=0;
-#endif
-</pre>
-
- };
- 
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_.constructor__base_transaction_object___"></a><a class="link" href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_.constructor__base_transaction_object___" title="Constructor base_transaction_object()">Constructor
- <code class="computeroutput">base_transaction_object()</code></a>
-</h5></div></div></div>
-<pre class="programlisting">base_transaction_object();
-</pre>
-
- Default constructor (ctor) with no parameters allows derived base_transaction_objects
- to implicitly construct the base_transaction_object base class for easier
- integration.
- 
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_.virtual_destructor___base_transaction_object___"></a><a class="link" href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_.virtual_destructor___base_transaction_object___" title="Virtual Destructor ~base_transaction_object()">Virtual
- Destructor <code class="computeroutput">~base_transaction_object()</code></a>
-</h5></div></div></div>
-<pre class="programlisting">virtual ~base_transaction_object() {};
-</pre>
-
- Virtual destructor (dtor) ensures correct destructors are called in the
- inheritance hierarchy for delete operations invoked on base_transaction_object
- pointers, which occur in numerous places throughout the internal transaction
- code.
- 
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__copy_state___"></a><a class="link" href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__copy_state___" title="Virtual function copy_state()">Virtual
- function <code class="computeroutput">copy_state()</code></a>
-</h5></div></div></div>
-<pre class="programlisting">virtual void copy_state(base_transaction_object const * const rhs) = 0;
-</pre>
-
- The <code class="computeroutput">copy_state()</code>
- method is called each time global memory is updated, for either direct
- or deferred updating policies. With this in mind, it is vital that the
- this object be set to the exact state of the input parameter.
- 
-
- Derived classes usually simply override this method and perform an <code class="computeroutput">operator=()</code>
- function call for the specific derived type.
- 
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__move_state___"></a><a class="link" href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__move_state___" title="Virtual function move_state()">Virtual
- function <code class="computeroutput">move_state()</code></a>
-</h5></div></div></div>
-<pre class="programlisting">virtual void move_state(base_transaction_object * rhs) = 0;
-</pre>
-
- The move_state() method is internally called at deferred updating commit
- time and at direct updating abort time and invokes the user-defined derived
- transaction class's move assignment (e.g. operator=(type &&)).
- 
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_.static_function__retrieve_mem___"></a><a class="link" href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_.static_function__retrieve_mem___" title="Static function retrieve_mem()">Static
- function <code class="computeroutput">retrieve_mem()</code></a>
-</h5></div></div></div>
-<pre class="programlisting">static void* retrieve_mem(size_t size);
-</pre>
-
- Static interface into TBoost.STM's memory management system for retrieving
- memory. The supplied parameter is the requested block size, the return
- parameter is a void* to the allocated block. Usually access to this interface
- is done by overloading operator new in the derived base_transaction_object
- class. Void pointers are the natural and preferred manner to handle memory
- allocations and deallocations and are therefore safe in this context.
- 
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_.static_function__return_mem___"></a><a class="link" href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_.static_function__return_mem___" title="Static function return_mem()">Static
- function <code class="computeroutput">return_mem()</code></a>
-</h5></div></div></div>
-<pre class="programlisting">static void return_mem(void *mem, size_t size);
-</pre>
-
- Static interface into TBoost.STM's memory management system for returning
- memory. The first parameter points to the memory block being returned,
- the second parameter specifies its size. Usually access to this interface
- is done by overloading operator delete in the derived transaction object
- class. Void pointers are the natural and preferred manner to handle memory
- allocations and deallocations and are therefore safe in this context.
- 
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_.static_function__alloc_size___"></a><a class="link" href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_.static_function__alloc_size___" title="Static function alloc_size()">Static
- function <code class="computeroutput">alloc_size()</code></a>
-</h5></div></div></div>
-<pre class="programlisting">static void alloc_size(size_t size);
-</pre>
-
- Static interface into TBoost.STM's memory management system which allows
- the user to specify the allocation chunk size for the memory manager.
- The input parameter specifies the number of transactional objects that
- should be allocated at startup and with each subsequent buffer increase.
- If no size is specified, the allocation chunk size uses TBoost.STM's
- default value, currently 8192. The alloc_size() interface can be reconfigured
- at runtime and is used upon the next buffer increase.
- 
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__cache_deallocate___"></a><a class="link" href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.abstract_class__base_transaction_object_.virtual_function__cache_deallocate___" title="Virtual function cache_deallocate()">Virtual
- function <code class="computeroutput">cache_deallocate()</code></a>
-</h5></div></div></div>
-<pre class="programlisting">virtual void cache_deallocate()=0;
-</pre>
-</div>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h4 class="title">
<a name="toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___"></a><a class="link" href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___" title="Template Class transaction_object<>">Template
 Class <code class="computeroutput">transaction_object<></code></a>
</h4></div></div></div>
<div class="toc"><dl>
+<dt><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___.virtual_function__clone___">Virtual
+ function <code class="computeroutput">clone()</code></a></dt>
<dt><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___.virtual_function__copy_state___">Virtual
 function <code class="computeroutput">copy_state()</code></a></dt>
<dt><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___.virtual_function__move_state___">Virtual
@@ -342,20 +82,33 @@
class transaction_object : public base_transaction_object {
public:

- virtual void copy_state(base_transaction_object const * const rhs);
- virtual void move_state(base_transaction_object * rhs);
+ virtual base_transaction_object* clone() const;
+ virtual void copy_state(base_transaction_object const * const rhs);
+ virtual void move_state(base_transaction_object * rhs);
};
</pre>
<div class="section" lang="en">
<div class="titlepage"><div><div><h5 class="title">
+<a name="toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___.virtual_function__clone___"></a><a class="link" href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___.virtual_function__clone___" title="Virtual function clone()">Virtual
+ function <code class="computeroutput">clone()</code></a>
+</h5></div></div></div>
+<pre class="programlisting">virtual base_transaction_object* clone() const;
+</pre>
+
+ The clone() method calls to the free function cache_new_copy which allocates
+ enough memory for the new object and then do a memcpy by default.
+ 
+</div>
+<div class="section" lang="en">
+<div class="titlepage"><div><div><h5 class="title">
<a name="toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___.virtual_function__copy_state___"></a><a class="link" href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___.virtual_function__copy_state___" title="Virtual function copy_state()">Virtual
 function <code class="computeroutput">copy_state()</code></a>
</h5></div></div></div>
<pre class="programlisting">virtual void copy_state(base_transaction_object const * const rhs);
</pre>

- The copy_state() method call to the free function cache_restore which
- do a unitialized_copy by default.
+ The copy_state() method call to the free function cache_copy which do
+ a memcpy by default.
 
</div>
<div class="section" lang="en">
@@ -366,8 +119,8 @@
<pre class="programlisting">virtual void move_state(base_transaction_object * rhs);
</pre>

- The move_state() method call to the free function cache_restore which
- do a unitialized_copy by default.
+ The move_state() method call to the free function cache_copy which do
+ a memcpy by default.
 
</div>
<div class="section" lang="en">
@@ -375,8 +128,12 @@
<a name="toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___.virtual_function__cache_deallocate___"></a><a class="link" href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__transaction_object___.virtual_function__cache_deallocate___" title="Virtual function cache_deallocate()">Virtual
 function <code class="computeroutput">cache_deallocate()</code></a>
</h5></div></div></div>
-<pre class="programlisting">virtual void cache_deallocate()=0;
+<pre class="programlisting">virtual void cache_deallocate();
</pre>
+
+ The cache_deallocate() method call to the free function cache_deallocate
+ which do a memcpy by default.
+ 
</div>
</div>
<div class="section" lang="en">
@@ -407,114 +164,6 @@
};
</pre>
</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h4 class="title">
-<a name="toward_boost_stm.reference.transaction_object_hpp.template_class__transactional_object___"></a><a class="link" href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__transactional_object___" title="Template Class transactional_object<>">Template
- Class <code class="computeroutput">transactional_object<></code></a>
-</h4></div></div></div>
-<div class="toc"><dl>
-<dt><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__transactional_object___.virtual_function__copy_state___">Virtual
- function <code class="computeroutput">copy_state()</code></a></dt>
-<dt><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__transactional_object___.virtual_function__move_state___">Virtual
- function <code class="computeroutput">move_state()</code></a></dt>
-<dt><a href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__transactional_object___.virtual_function__cache_deallocate___">Virtual
- function <code class="computeroutput">cache_deallocate()</code></a></dt>
-</dl></div>
-
- Transactional object wrapper. A <code class="computeroutput">transactional_object<T></code> is a base_transaction_object wrapping
- an instance of type T. Provides the definition of the virtual functions
- 
-<div class="itemizedlist"><ul type="disc">
-<li>
- forward constructors to the wrapped type
- </li>
-<li>
-<code class="computeroutput">copy_state</code>: relaying
- on the cache_restore<T> generic function
- </li>
-<li>
-<code class="computeroutput">move_state</code> and
- </li>
-<li>
-<code class="computeroutput">cache_deallocate</code>: relaying
- on the cache_restore<T> generic function
- </li>
-</ul></div>
-
- Defines in addition the functions <code class="computeroutput">new</code>
- and <code class="computeroutput">delete</code> when <code class="computeroutput">BOOST_STM_USE_MEMORY_MANAGER</code> is defined
- 
-
- If a class D inherits from B we have that <code class="computeroutput">transactional_object<D></code> dont inherits from <code class="computeroutput">transactional_object<B></code>, but we can static/dynamic cast them
- robustly.
- 
-
- Evidently the <code class="computeroutput">std::static_cast</code>/<code class="computeroutput">std::dynamic_cast</code>
- do not works. We need to define the specific cast
- 
-<pre class="programlisting">transactional_object<D>* d=...;
-transactional_object<B>* b=tx_static_cast<B>(d);
-
-transactional_object<B>* b=...;
-transactional_object<D>* d=tx_dynamic_cast<B>(b);
-</pre>
-
- Synopsis
- 
-<pre class="programlisting">template <typename T>
-class transactional_object : public base_transaction_object {
-public:
- T value;
-
- transactional_object();
- transactional_object(const T*ptr);
- transactional_object(transactional_object<T> const & r);
- template <typename T1>
- transactional_object(T1 const &p1);
-
- template <typename T1, typename T2>
- transactional_object(T1 const &p1, T2 const &p2);
-
- transactional_object & operator=(transactional_object const & r);
-
- virtual void copy_state(base_transaction_object const * const rhs);
-
-#ifdef BOOST_STM_USE_UNASIGNED_COPY
- virtual void cache_deallocate();
-#endif
-
-#if BOST_STM_USE_MEMORY_MANAGER
- void* operator new(size_t size) throw ();
- void operator delete(void* mem);
-#endif
-
-};
-</pre>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_object_hpp.template_class__transactional_object___.virtual_function__copy_state___"></a><a class="link" href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__transactional_object___.virtual_function__copy_state___" title="Virtual function copy_state()">Virtual
- function <code class="computeroutput">copy_state()</code></a>
-</h5></div></div></div>
-<pre class="programlisting">virtual void copy_state(base_transaction_object const * const rhs);
-</pre>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_object_hpp.template_class__transactional_object___.virtual_function__move_state___"></a><a class="link" href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__transactional_object___.virtual_function__move_state___" title="Virtual function move_state()">Virtual
- function <code class="computeroutput">move_state()</code></a>
-</h5></div></div></div>
-<pre class="programlisting">virtual void move_state(base_transaction_object * rhs);
-</pre>
-</div>
-<div class="section" lang="en">
-<div class="titlepage"><div><div><h5 class="title">
-<a name="toward_boost_stm.reference.transaction_object_hpp.template_class__transactional_object___.virtual_function__cache_deallocate___"></a><a class="link" href="transaction_object_hpp.html#toward_boost_stm.reference.transaction_object_hpp.template_class__transactional_object___.virtual_function__cache_deallocate___" title="Virtual function cache_deallocate()">Virtual
- function <code class="computeroutput">cache_deallocate()</code></a>
-</h5></div></div></div>
-<pre class="programlisting">virtual void cache_deallocate()=0;
-</pre>
-</div>
-</div>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
@@ -526,7 +175,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="transaction_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="tx_ptr_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="transaction_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="transactional_object_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/transactional_object_hpp.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/transactional_object_hpp.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/reference/transactional_object_hpp.html 2009-09-22 14:14:13 EDT (Tue, 22 Sep 2009)
@@ -6,7 +6,7 @@
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
<link rel="start" href="../../index.html" title="Chapter 1. Toward.Boost.STM">
<link rel="up" href="../reference.html" title="Reference">
-<link rel="prev" href="base_transaction_hpp.html" title="Header <boost/stm/base_transaction.hpp>">
+<link rel="prev" href="transaction_object_hpp.html" title="Header <boost/stm/transaction_object.hpp>">
<link rel="next" href="tx_ptr_hpp.html" title="Header <boost/stm/tx_ptr.hpp>">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -20,7 +20,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="base_transaction_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="tx_ptr_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="transaction_object_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="tx_ptr_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
</div>
<div class="section" lang="en">
<div class="titlepage"><div><div><h3 class="title">
@@ -171,7 +171,7 @@
</tr></table>
<hr>
<div class="spirit-nav">
-<a accesskey="p" href="base_transaction_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="tx_ptr_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
+<a accesskey="p" href="transaction_object_hpp.html"><img src="../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="tx_ptr_hpp.html"><img src="../../../../../../doc/html/images/next.png" alt="Next"></a>
</div>
</body>
</html>

Modified: sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/users_guide/tutorial.html
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/users_guide/tutorial.html (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/html/toward_boost_stm/users_guide/tutorial.html 2009-09-22 14:14:13 EDT (Tue, 22 Sep 2009)
@@ -816,10 +816,10 @@
 How the user can defien a transactional class D inheriting from a transactional
 class B
 
-<a name="toward_boost_stm.users_guide.tutorial.polymorphic.using_the_mixin_transaction_object_lt__gt_"></a><h6>
+<a name="toward_boost_stm.users_guide.tutorial.polymorphic._mixin_using_the_mixin_transaction_object_lt__gt_"></a><h6>
<a name="id4868388"></a>
- <a class="link" href="tutorial.html#toward_boost_stm.users_guide.tutorial.polymorphic.using_the_mixin_transaction_object_lt__gt_">Using
- the mixin transaction_object<></a>
+ <a class="link" href="tutorial.html#toward_boost_stm.users_guide.tutorial.polymorphic._mixin_using_the_mixin_transaction_object_lt__gt_">:mixin
+ Using the mixin transaction_object<></a>
 </h6>

 Let B the base class
@@ -848,10 +848,10 @@
<pre class="programlisting">write_ptr<B*> tx_ptr_b_ptr(_,ptr_b);
*ptr_b = BOOST_STM_NEW(_, D())
</pre>
-<a name="toward_boost_stm.users_guide.tutorial.polymorphic.using_the_mixin_transaction_object_lt__gt_"></a><h6>
-<a name="id4868706"></a>
- <a class="link" href="tutorial.html#toward_boost_stm.users_guide.tutorial.polymorphic.using_the_mixin_transaction_object_lt__gt_">Using
- the mixin transaction_object<></a>
+<a name="toward_boost_stm.users_guide.tutorial.polymorphic.__wrapper_using_the_wrapper_transactional_object_lt__gt_"></a><h6>
+<a name="id4868709"></a>
+ <a class="link" href="tutorial.html#toward_boost_stm.users_guide.tutorial.polymorphic.__wrapper_using_the_wrapper_transactional_object_lt__gt_">::wrapper
+ Using the wrapper transactional_object<></a>
 </h6>
</div>
<div class="section" lang="en">

Modified: sandbox/stm/branches/vbe/libs/stm/doc/reference.qbk
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/reference.qbk (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/reference.qbk 2009-09-22 14:14:13 EDT (Tue, 22 Sep 2009)
@@ -12,17 +12,20 @@

[/include reference/stm.qbk]
[/include reference/rt_configuration.qbk]
+[include reference/base_contention_manager.qbk]
+[include reference/base_transaction_object.qbk]
+[include reference/cache_fct.qbk]
+[/include reference/contention_manager/default_contention_manager.qbk]
+[/include reference/contention_manager/NoExceptionOnAbortNoticeOnReadWritesCM.qbk]
+[/include reference/contention_manager/ExceptAndBackOffOnAbortNoticeCM.qbk]
[include reference/data_types.qbk]
[include reference/exceptions.qbk]
+[include reference/language_like.qbk]
[/include reference/synchro.qbk]
[include reference/transaction.qbk]
[include reference/transaction_object.qbk]
+[/include reference/transaction_object_ptr.qbk]
[include reference/smart_pointers.qbk]
-[include reference/base_contention_manager.qbk]
-[include reference/language_like.qbk]
-[/include reference/contention_manager/default_contention_manager.qbk]
-[/include reference/contention_manager/NoExceptionOnAbortNoticeOnReadWritesCM.qbk]
-[/include reference/contention_manager/ExceptAndBackOffOnAbortNoticeCM.qbk]
[include reference/transaction_bookkeeping.qbk]

[endsect]

Added: sandbox/stm/branches/vbe/libs/stm/doc/reference/base_transaction_object.qbk
==============================================================================
--- (empty file)
+++ sandbox/stm/branches/vbe/libs/stm/doc/reference/base_transaction_object.qbk 2009-09-22 14:14:13 EDT (Tue, 22 Sep 2009)
@@ -0,0 +1,149 @@
+[/
+ (C) Copyright 2009 Justin E. Gottchlich.
+ (C) Copyright 2009 Vicente J. Botet Escriba
+ /
+ / Distributed under the Boost Software License, Version 1.0. (See accompanying
+ / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ /]
+
+
+[/==========================================================================================]
+[section:base_transaction_object_hpp Header `<boost/stm/base_transaction_object.hpp>`]
+[/==========================================================================================]
+
+ namespace boost { namespace stm {
+ class base_transaction_object;
+ }}
+
+[section Abstract Class `base_transaction_object`]
+
+This is the base class of all the transactional objects. It tracks:
+
+* `transactionThread_`: the thread identifier holding the write acces to this transactional object
+* `transaction_`: the pointer to the transaction
+* `version_`: the version when performing validation
+* `newMemory_`: states whether this object is a new object
+
+Transactional objets must specialize the pure virtual functions
+
+* `copy_state(base_transaction_object const * const rhs)`
+* `move_state(base_transaction_object * rhs)` if `BUILD_MOVE_SEMANTICS`
+* `cache_deallocate()` if `BOOST_STM_USE_UNASIGNED_COPY`
+
+`copy_state` is used to copy the backup/working copy to the shared transactional object when the roolback/commit is done direct/defered policy is used.
+
+`move_state` is used to move the backup/working copy to the shared transactional object when the roolback/commit is done direct/defered policy is used.
+
+`cache_deallocate` is used to release the backup/working copy when the transaction ends if direct/defered policy is used.
+
+When USE_STM_MEMORY_MANAGER is defined this class provides two functions (`retrieve_mem` and `return_mem`) and to manage a pool of memory.
+
+
+ class base_transaction_object
+ {
+ public:
+
+ base_transaction_object();
+ virtual ~base_transaction_object() {};
+
+ virtual base_transaction_object* clone() const = 0;
+ virtual void copy_state(base_transaction_object const * const rhs) = 0;
+ virtual void move_state(base_transaction_object * rhs) = 0;
+
+ void transaction_thread(thread_id rhs) const;
+ thread_id transaction_thread() const;
+
+ void new_memory(bool rhs)
+ bool new_memory() const;
+
+ #if BOOST_STM_PERFORMING_VALIDATION
+ void version(std::size_t rhs);
+ std::size_t version() const;
+ #endif
+
+ #if BOOST_STM_USE_MEMORY_MANAGER
+ static void return_mem(void *mem, size_t size);
+ static void* retrieve_mem(size_t size);
+ static void alloc_size(size_t size);
+ #endif
+
+ #ifdef BOOST_STM_USE_UNASIGNED_COPY
+ virtual void cache_deallocate()=0;
+ #endif
+
+ };
+
+[section Constructor `base_transaction_object()`]
+
+ base_transaction_object();
+
+Default constructor (ctor) with no parameters allows derived base_transaction_objects to implicitly construct the base_transaction_object base class for easier integration.
+
+[endsect]
+
+[section Virtual Destructor `~base_transaction_object()`]
+
+ virtual ~base_transaction_object() {};
+
+Virtual destructor (dtor) ensures correct destructors are called in the inheritance hierarchy for delete operations invoked on base_transaction_object pointers, which occur in numerous places throughout the internal transaction code.
+
+[endsect]
+
+[section Virtual function `copy_state()`]
+
+ virtual void copy_state(base_transaction_object const * const rhs) = 0;
+
+
+The `copy_state()` method is called each time global memory is updated, for either direct or deferred updating policies. With this in mind, it is vital that the this object be set to the exact state of the input parameter.
+
+Derived classes usually simply override this method and perform an `operator=()` function call for the specific derived type.
+
+[endsect]
+
+
+[section Virtual function `move_state()`]
+
+ virtual void move_state(base_transaction_object * rhs) = 0;
+
+The move_state() method is internally called at deferred updating commit time and at direct updating abort time and invokes the user-defined derived transaction class's move assignment (e.g. operator=(type &&)).
+
+[endsect]
+
+[section Static function `retrieve_mem()`]
+
+ static void* retrieve_mem(size_t size);
+
+Static interface into __Boost_STM_s__ memory management system for retrieving memory. The supplied parameter is the requested block size, the return parameter is a void* to the allocated block. Usually access to this interface is done by overloading operator new in the derived base_transaction_object class. Void pointers are the natural and preferred manner to handle memory allocations and deallocations and are therefore safe in this context.
+
+[endsect]
+
+
+[section Static function `return_mem()`]
+
+ static void return_mem(void *mem, size_t size);
+
+Static interface into __Boost_STM_s__ memory management system for returning memory. The first parameter points to the memory block being returned, the second parameter specifies its size. Usually access to this interface is done by overloading operator delete in the derived transaction object class. Void pointers are the natural and preferred manner to handle memory allocations and deallocations and are therefore safe in this context.
+
+[endsect]
+
+[section Static function `alloc_size()`]
+
+ static void alloc_size(size_t size);
+
+Static interface into __Boost_STM_s__ memory management system which allows the user to specify the allocation chunk size for the memory manager. The input parameter specifies the number of transactional objects that should be allocated at startup and with each subsequent buffer increase. If no size is specified, the allocation chunk size uses __Boost_STM_s__ default value, currently 8192. The alloc_size() interface can be reconfigured at runtime and is used upon the next buffer increase.
+
+[endsect]
+
+[section Virtual function `cache_deallocate()`]
+
+ virtual void cache_deallocate()=0;
+
+[endsect]
+
+
+[endsect]
+
+
+[endsect]
+
+

Added: sandbox/stm/branches/vbe/libs/stm/doc/reference/cache_fct.qbk
==============================================================================
--- (empty file)
+++ sandbox/stm/branches/vbe/libs/stm/doc/reference/cache_fct.qbk 2009-09-22 14:14:13 EDT (Tue, 22 Sep 2009)
@@ -0,0 +1,86 @@
+[/
+ (C) Copyright 2009 Justin E. Gottchlich.
+ (C) Copyright 2009 Vicente J. Botet Escriba
+ /
+ / Distributed under the Boost Software License, Version 1.0. (See accompanying
+ / file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
+ /]
+
+
+[/==========================================================================================]
+[section:cache_fct_hpp Header `<boost/stm/cache_fct.hpp>`]
+[/==========================================================================================]
+
+ namespace boost { namespace stm {
+ template <class T> T* cache_clone(const T& val);
+ template <class T> void cache_copy(const T* const ori, T* target);
+ void cache_release(base_transaction_object* ptr);
+
+ template <class T> T* cache_allocate();
+ template <class T> void cache_deallocate(T*);
+
+ }}
+
+
+[section Template Function `cache_clone<>()`]
+
+ template <class T>
+ T* cache_clone(const T& val);
+
+Makes a new copy of the parameter. Allocates an object of type T using the `cache_allocate` function and copy from the given parameter `val` using the free function `cache_copy`.
+
+The user can overload this function, as __Boost_STM__ uses ADL to access it.
+
+When `BOOST_STM_NO_PARTIAL_SPECIALIZATION` is defined, i.e. on compilers not supporting partial template specialization, the function calls to `partial_specialization_workaround::cache_clone<T>::apply(val)`. So the user will need to overload the class `partial_specialization_workaround::cache_clone<T>` defining the function
+
+ static T* apply(const T& val);
+
+[endsect]
+
+
+[section Template Function `cache_copy<>()`]
+
+ template <class T>
+ void cache_copy(const T* const source, T* target);
+
+Copy from souce to target using memcpy by default.
+
+The user can overload this function, as __Boost_STM__ uses ADL to access it.
+
+When `BOOST_STM_NO_PARTIAL_SPECIALIZATION` is defined, i.e. on compilers not supporting partial template specialization, the function calls to `partial_specialization_workaround::cache_copy<T>::apply(source, target)`. So the user will need to overload the class `partial_specialization_workaround::cache_copy<T>` defining the function
+
+ static T* apply(const T* const source, T* target);
+
+[endsect]
+
+[section Function `cache_release<>()`]
+
+ void cache_release(base_transaction_object* ptr) {
+
+Release the given base_transaction_object by calling to the virtual function `cache_dealocate`.
+
+[endsect]
+
+
+[section Template Function `cache_allocate<>()`]
+
+ template <class T>
+ T* cache_allocate();
+
+Allocates an instance of calls T. Depending on whether BOOST_STM_CACHE_USE_MEMORY_MANAGER, BOOST_STM_CACHE_USE_MALLOC or BOOST_STM_CACHE_USE_TSS_MONOTONIC_MEMORY_MANAGER are defined this function will use the static pool of the class T, malloc or the thread specific monotonic allocator.
+
+[endsect]
+
+[section Template Function `cache_deallocate<>()`]
+
+ template <class T>
+ void cache_deallocate(T*ptr) {
+
+Deallocates an instance of calls T. Depending on whether BOOST_STM_CACHE_USE_MEMORY_MANAGER, BOOST_STM_CACHE_USE_MALLOC or BOOST_STM_CACHE_USE_TSS_MONOTONIC_MEMORY_MANAGER are defined this function will use the static pool of the class T, free or the no-op.
+
+[endsect]
+
+
+[endsect]
+
+

Modified: sandbox/stm/branches/vbe/libs/stm/doc/reference/data_types.qbk
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/reference/data_types.qbk (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/reference/data_types.qbk 2009-09-22 14:14:13 EDT (Tue, 22 Sep 2009)
@@ -1,5 +1,5 @@
[/
- (C) Copyright 2009 Justin E. Gottchlich.
+ (C) Copyright 2009 Justin E. Gottchlich.
   (C) Copyright 2009 Vicente J. Botet Escriba
  /
  / Distributed under the Boost Software License, Version 1.0. (See accompanying
@@ -20,9 +20,23 @@

[section Enum `transaction_type`]

+ enum transaction_type
+ {
+ eNormalTx,
+ eIrrevocableTx,
+ eIrrevocableAndIsolatedTx
+ };
+
[endsect]
[section Enum `latm_type`]

+ enum latm_type
+ {
+ eFullLatmProtection,
+ eTmConflictingLockLatmProtection,
+ eTxConflictingLockLatmProtection
+ };
+
[endsect]
[section Enum `transaction_state`]

@@ -38,6 +52,8 @@
[endsect]
[section Typedef `thread_id_t`]

+ typedef platform_specific thread_id_t;
+
[endsect]
[endsect]

Modified: sandbox/stm/branches/vbe/libs/stm/doc/reference/transaction_object.qbk
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/reference/transaction_object.qbk (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/reference/transaction_object.qbk 2009-09-22 14:14:13 EDT (Tue, 22 Sep 2009)
@@ -8,210 +8,14 @@

[/==========================================================================================]
-[section:base_transaction_hpp Header `<boost/stm/base_transaction.hpp>`]
+[section:transaction_object_hpp Header `<boost/stm/transaction_object.hpp>`]
[/==========================================================================================]

 namespace boost { namespace stm {
- class base_transaction_object;
-
- template <class T> T* cache_clone(const T& val);
- template <class T> void cache_copy(const T* const ori, T* target);
- void cache_release(base_transaction_object* ptr);
-
- template <class T> T* cache_allocate();
- template <class T> void cache_deallocate(T*);
-
-
 template <class Derived> class transaction_object;
 template <typename T> class native_trans;
 }}

-[section Abstract Class `base_transaction_object`]
-
-This is the base class of all the transactional objects. It tracks:
-
-* `transactionThread_`: the thread identifier holding the write acces to this transactional object
-* `transaction_`: the pointer to the transaction
-* `version_`: the version when performing validation
-* `newMemory_`: states whether this object is a new object
-
-Transactional objets must specialize the pure virtual functions
-
-* `copy_state(base_transaction_object const * const rhs)`
-* `move_state(base_transaction_object * rhs)` if `BUILD_MOVE_SEMANTICS`
-* `cache_deallocate()` if `BOOST_STM_USE_UNASIGNED_COPY`
-
-`copy_state` is used to copy the backup/working copy to the shared transactional object when the roolback/commit is done direct/defered policy is used.
-
-`move_state` is used to move the backup/working copy to the shared transactional object when the roolback/commit is done direct/defered policy is used.
-
-`cache_deallocate` is used to release the backup/working copy when the transaction ends if direct/defered policy is used.
-
-When USE_STM_MEMORY_MANAGER is defined this class provides two functions (`retrieve_mem` and `return_mem`) and to manage a pool of memory.
-
-
- class base_transaction_object
- {
- public:
-
- base_transaction_object();
- virtual ~base_transaction_object() {};
-
- virtual base_transaction_object* clone() const = 0;
- virtual void copy_state(base_transaction_object const * const rhs) = 0;
- virtual void move_state(base_transaction_object * rhs) = 0;
-
- void transaction_thread(thread_id rhs) const;
- thread_id transaction_thread() const;
-
- void new_memory(bool rhs)
- bool new_memory() const;
-
- #if BOOST_STM_PERFORMING_VALIDATION
- void version(std::size_t rhs);
- std::size_t version() const;
- #endif
-
- #if BOOST_STM_USE_MEMORY_MANAGER
- static void return_mem(void *mem, size_t size);
- static void* retrieve_mem(size_t size);
- static void alloc_size(size_t size);
- #endif
-
- #ifdef BOOST_STM_USE_UNASIGNED_COPY
- virtual void cache_deallocate()=0;
- #endif
-
- };
-
-[section Constructor `base_transaction_object()`]
-
- base_transaction_object();
-
-Default constructor (ctor) with no parameters allows derived base_transaction_objects to implicitly construct the base_transaction_object base class for easier integration.
-
-[endsect]
-
-[section Virtual Destructor `~base_transaction_object()`]
-
- virtual ~base_transaction_object() {};
-
-Virtual destructor (dtor) ensures correct destructors are called in the inheritance hierarchy for delete operations invoked on base_transaction_object pointers, which occur in numerous places throughout the internal transaction code.
-
-[endsect]
-
-[section Virtual function `copy_state()`]
-
- virtual void copy_state(base_transaction_object const * const rhs) = 0;
-
-
-The `copy_state()` method is called each time global memory is updated, for either direct or deferred updating policies. With this in mind, it is vital that the this object be set to the exact state of the input parameter.
-
-Derived classes usually simply override this method and perform an `operator=()` function call for the specific derived type.
-
-[endsect]
-
-
-[section Virtual function `move_state()`]
-
- virtual void move_state(base_transaction_object * rhs) = 0;
-
-The move_state() method is internally called at deferred updating commit time and at direct updating abort time and invokes the user-defined derived transaction class's move assignment (e.g. operator=(type &&)).
-
-[endsect]
-
-[section Static function `retrieve_mem()`]
-
- static void* retrieve_mem(size_t size);
-
-Static interface into __Boost_STM_s__ memory management system for retrieving memory. The supplied parameter is the requested block size, the return parameter is a void* to the allocated block. Usually access to this interface is done by overloading operator new in the derived base_transaction_object class. Void pointers are the natural and preferred manner to handle memory allocations and deallocations and are therefore safe in this context.
-
-[endsect]
-
-
-[section Static function `return_mem()`]
-
- static void return_mem(void *mem, size_t size);
-
-Static interface into __Boost_STM_s__ memory management system for returning memory. The first parameter points to the memory block being returned, the second parameter specifies its size. Usually access to this interface is done by overloading operator delete in the derived transaction object class. Void pointers are the natural and preferred manner to handle memory allocations and deallocations and are therefore safe in this context.
-
-[endsect]
-
-[section Static function `alloc_size()`]
-
- static void alloc_size(size_t size);
-
-Static interface into __Boost_STM_s__ memory management system which allows the user to specify the allocation chunk size for the memory manager. The input parameter specifies the number of transactional objects that should be allocated at startup and with each subsequent buffer increase. If no size is specified, the allocation chunk size uses __Boost_STM_s__ default value, currently 8192. The alloc_size() interface can be reconfigured at runtime and is used upon the next buffer increase.
-
-[endsect]
-
-[section Virtual function `cache_deallocate()`]
-
- virtual void cache_deallocate()=0;
-
-[endsect]
-
-
-[endsect]
-
-[section Template Function `cache_clone<>()`]
-
- template <class T>
- T* cache_clone(const T& val);
-
-Makes a new copy of the parameter. Allocates an object of type T using the `cache_allocate` function and copy from the given parameter `val` using the free function `cache_copy`.
-
-The user can overload this function, as __Boost_STM__ uses ADL to access it.
-
-When `BOOST_STM_NO_PARTIAL_SPECIALIZATION` is defined, i.e. on compilers not supporting partial template specialization, the function calls to `partial_specialization_workaround::cache_clone<T>::apply(val)`. So the user will need to overload the class `partial_specialization_workaround::cache_clone<T>` defining the function
-
- static T* apply(const T& val);
-
-[endsect]
-
-
-[section Template Function `cache_copy<>()`]
-
- template <class T>
- void cache_copy(const T* const source, T* target);
-
-Copy from souce to target using memcpy by default.
-
-The user can overload this function, as __Boost_STM__ uses ADL to access it.
-
-When `BOOST_STM_NO_PARTIAL_SPECIALIZATION` is defined, i.e. on compilers not supporting partial template specialization, the function calls to `partial_specialization_workaround::cache_copy<T>::apply(source, target)`. So the user will need to overload the class `partial_specialization_workaround::cache_copy<T>` defining the function
-
- static T* apply(const T* const source, T* target);
-
-[endsect]
-
-[section Function `cache_release<>()`]
-
- void cache_release(base_transaction_object* ptr) {
-
-Release the given base_transaction_object by calling to the virtual function `cache_dealocate`.
-
-[endsect]
-
-
-[section Template Function `cache_allocate<>()`]
-
- template <class T>
- T* cache_allocate();
-
-Allocates an instance of calls T. Depending on whether BOOST_STM_CACHE_USE_MEMORY_MANAGER, BOOST_STM_CACHE_USE_MALLOC or BOOST_STM_CACHE_USE_TSS_MONOTONIC_MEMORY_MANAGER are defined this function will use the static pool of the class T, malloc or the thread specific monotonic allocator.
-
-[endsect]
-
-[section Template Function `cache_deallocate<>()`]
-
- template <class T>
- void cache_deallocate(T*ptr) {
-
-Deallocates an instance of calls T. Depending on whether BOOST_STM_CACHE_USE_MEMORY_MANAGER, BOOST_STM_CACHE_USE_MALLOC or BOOST_STM_CACHE_USE_TSS_MONOTONIC_MEMORY_MANAGER are defined this function will use the static pool of the class T, free or the no-op.
-
-[endsect]
-
[section Template Class `transaction_object<>`]

To further simplify the usage of __Boost_STM__, an intermediate template class was built which is meant to sit between the base_transaction_object and the user-defined transaction objects. The purpose of this intermediate class is to reduce the code overhead needed for user-defined transaction objects. To do this, the curiously recurring template pattern developed by James Coplien was used.

Added: sandbox/stm/branches/vbe/libs/stm/doc/stm.pdf
==============================================================================
Binary file. No diff available.

Modified: sandbox/stm/branches/vbe/libs/stm/doc/tutorial.qbk
==============================================================================
--- sandbox/stm/branches/vbe/libs/stm/doc/tutorial.qbk (original)
+++ sandbox/stm/branches/vbe/libs/stm/doc/tutorial.qbk 2009-09-22 14:14:13 EDT (Tue, 22 Sep 2009)
@@ -433,7 +433,7 @@

How the user can defien a transactional class D inheriting from a transactional class B

-[heading Using the mixin transaction_object<>]
+[heading:mixin Using the mixin transaction_object<>]

Let B the base class

@@ -457,7 +457,7 @@
write_ptr<B*> tx_ptr_b_ptr(_,ptr_b);
*ptr_b = BOOST_STM_NEW(_, D())

-[heading Using the mixin transaction_object<>]
+[heading::wrapper Using the wrapper transactional_object<>]

[endsect]

Date view	Thread view	Subject view	Author view

Boost-Commit list run by bdawes at acm.org, david.abrahams at rcn.com, gregod at cs.rpi.edu, cpdaniel at pacbell.net, john at johnmaddock.co.uk