User guide extended with Java API examples

 - section 'Behavior changes'