add simple examples
fixes, simplifications, additions to x.cca methods, update docs