docs: Document generated headers caveats for genmarshal

And also link to the Meson FAQ that explains why this is needed so people aren't just cargo-culting code.

Continuation from !861 (merged).

Note: I just copied the paragraphs about generated headers from the glib-mkenums documentation.