introduce example of smartClearSnapshot usage (note that the code is never used)
Merge branch 'master' into clear-snapshot-example
Fix compatibility, as the branch shows the use of the forthcoming APIs
Clarify the example of clearSnapshot.
Merge branch 'master' into clear-snapshot-example
Merge branch 'master' into clear-snapshot-example