mainpage.dox: Fix warnings and nicify documentation a bit
mainpage.dox: Fix warnings and nicify documentation a bit

@ref can only be used for existing anchors. And by using our `@latexonly`
hacks we can also highlight igor code nicely.

t-b/igor-unit-testing-framework,t-b/igor-unit-testing-framework