added more informative error message for common issue

fixes #1075

this is replacing #1271, which will need a little more effort to work correctly.