fixed typo
doc update
minor clean ups
fix for broken validity check
bpmapply for all params; exported; some fixes; test