documentation: explain preprocessor error

closes #342