add --broad option

This patch adds the --broad option to the wrapper, creates a proper readme file and includes some style fixes.