#1205 Fixes plugin extra search path
#1205 Fixes lint
#1205 Improved error message
#1202: document and reorganize top-level cmake

this makes no changes, only re-groups and documents things