doc: synopsis: made things a bit clearer.