ok, the manual could reeeeeally benefit from an example
good news: more hints have just been added to the manual :D
