add a synopsis to the main doco