doc: use synopsis where appropriate.