On the 'shelve' branch: In BRANCH-README, explain the branch relationships.
-This branch is for development of Shelving and Checkpointing.
+This branch is for development of Shelving [0,1].
Branch type: dev branch off trunk; updated by full merges from trunk.
+The following branching hierarching shows the intended propogation of changes,
+although the actual copy history of the branches is not as shown here.
+
+ trunk ------------------------ . catch-up
+ \ | merges
+ branches/shelve +------------------ V . .
+ \ \ | |
+ branches/checkpoint \ +----------- V |
+ \ |
+ branches/checkpoint3 +----------- V
+
+Both of the Checkpointing branches therefore include Shelving functionality.
+
Initially this is prototyping, to explore the general shape of the design and
user interface. As such, it does not take care over details of APIs and error
handling and so on.
