add hook for autogeneration code

[mk270]

this gives us the option of making the autogeneration much less brittle

[samaaron]

Ah cool, neat idea - I'll play around with this. Looks like it'll also get round the annoyance of not being able to put line breaks in the HTML strings.

[mk270]

My idea is call the ruby stuff from a script in ..../qt, and have it dump sensibly-named files in .../qt/help, and then use this hook to pull them in at compile-time.

Separately, this machinery wants to be in a file outside mainwindow.cpp, to minimise cockups on the "git diff" / "git commit" front

[samaaron]

Agreed.

I'm also unsure that this doc system is the actual way to go. It's just what I managed to be able to knock up in a few days with minimal Qt knowledge. I'd much prefer it to be indexable and for the structured parts be more elegantly formatted than styleless HTML. I'd love to use table structures with expansion where appropriate. Baby steps first though :-)