User guide extended with Java API examples

 - section 'Snapshot'
 - Java API improvements