[Spirit-general] Useful advice on compilation errors in spirit headers

[John R. <j....@ma...>]

AFAICT wrestling with long compiler error messages is the largest
barrier to learn how to use spirit. I've only just realised that quite
often the last spirit header in the compilation error contains advice
about what might be wrong with the grammar, generator,...

Is this documented anywhere? It would have helped me enormously.

Also is it possible to put the helpful text that is in the commented
code into the compiler error messages? I'm guessing this might be quite
some work and/or would slow down compilation even further.

John.