doxygen: don't include function parameter names in search results.

Too damn long.

doxygen: strip HTML tags from function param types in search.

doxygen: search result clarity improvements.

 * Function/macro params and suffix (such as const&&) is included in
   search results.
 * Directories are displayed with / at the end.
 * Parent pages are included in the name.

In order to properly highlight the typed value, a new "suffix length"
field is introduced in the result map, saying how much text there
is after the matching trie entry.

Also, in order to display the right angle quote for subpages, a bunch of
UTF-8-awareness fixes was done across the code.

package/ci: JS testing on Travis.

doxygen: updated docs about unit testing and coverage to include JS.

doxygen: fix case where pages are subpages of index.

Avoid the assertion, include the index page in the page tree and link to
index.html instead of indexpage.html.

doxygen: don't die if a page doesn't have a title.

But use its name instead.

doxygen: initial client-side search implementation.

doxygen: save half of node size, as it is aligned to 16bit.

Makes it possible to run on the whole Magnum symbol tree.

doxygen: assert that the search trie consists only of lowercase data.

Can't use `assert c.islower()` as that returns False on non-alnum chars.
Huh.

doxygen: serializing search result map and everything together.

doxygen: ability to print trie stats in the pretty printer.

doxygen: implement subtree merging.

Reduces size of the test case from 514 bytes to 340. Also the
visualization tool can visualize where the trees were cut off.

doxygen: ability to use the pretty trie printer from a command-line.

doxygen: initial Trie building & serialization implementation.

doxygen: loudly ignore member groups without a \name instead of asserting.

doxygen: render Reference in TOC only if there is some reference.

doxygen: don't be so strict about directory parents.

There can be quite a mess.

doxygen: fix section merging with return value docs involved.

doxygen: more flexible table rendering.

Support more consecutive table header rows, allow <th> elements inside
<tbody>.

doxygen: support `\param x, y, z Description`.

Oh, so that explains the massive complexity of the XML output. Ugh.

doxygen: don't die on empty elements.

Include the block ones in the output, remove the inline ones.

doxygen: support math formulas in custom environment.

And also be more generous with spacing.

doxygen: groups can have inner classes, too.

doxygen: more flexible function argument array parsing.

doxygen: be less strict when parsing \param and \return.

They can be scattered around the documentation block, in different
paragraphs. Combine them together and reorder as they should be.

doxygen: don't die on XML parse error.

Doxygen is able to highlight PNGs as C++ code. It's amazing, of
course, but the result is a terrible mess (of course). So let's have
another drink and ignore those *amazing things*.

doxygen: complain instead of blowing up if more \return-s are present.

doxygen: make it possible to call this script from an arbitrary dir.

Finally. One step closer to having a pip package.

doxygen: initial support for modules.

Module reference, module index, detecting module hierarchy for
breadcrumb and index.

doxygen: generate empty index page in case nothing is supplied for it.

So the documentation has some entry point.

doxygen: ignore RCS strings to avoid assertions.

doxygen: support <pre> tags.

I can't comprehend why there is a separate <verbatim> and
<preformatted> tag.

doxygen: solve all problems of mankind by making paths absolute.

Exclude test directories from coverage report.

package/ci: no need to pretend that we have coverage for Jinja2.

doxygen: try to test more stuff on 1.8.13.

css: clean up and remove redundant stuff from header styling.

By accident the spacing between items was 1.75rem, now it's 2rem. Maybe
too much (but perfectly okay for submenus and the mobile layout), might
change later.

Added codecov.io badge to README.

package/ci: upload code coverage to codecov.io.

site: enable the math-as-code fallback.

m.math: ability of fallback to rendering math as code blocks.

m.code: properly preserve backslashes in inline :code:.

The test now passes again.

m.code: test that backslashes in inline :code: are properly preserved.

They are not.

doc: properly specify the :css: interpreted text role in doxygen.rst.

doc: document base/derived classes in the doxygen template.

doxygen: aaand now the coverage is 100%.

doxygen: warn when export macros are spotted in the output.

doxygen: test that example pages work even without breadcrumb/footer nav.

doxygen: properly ignore empty/private documentation pages.

doxygen: dedicated test for ignoring empty documentation files.

doxygen: skip the example test on Doxygen < 1.8.14.

doxygen: remove pointless restrictions for valid use cases.

And add a test there.

doxygen: list base and derived classes.

doxygen: moved test for \m_footernavigation to a better place.

Because I was searching for it everywhere but here.

doxygen: new \m_examplenavigation command.

This tests the example page for the first time. So I took the
opportunity and also renamed the title suffix to "source" instead of
"example".

site: build status page.

Basically stolen from Magnum.

m.gl: ability to link to WebGL extensions.

doc++

package/ci: assign unique IDs to builds.

So I can display them in the build status.

Revert "package/ci: use Doxygen 1.8.14 on Travis."

It depends on libclang.so.6 which is ... well, nowhere to be found.

This reverts commit 4fce7d16e1ab3167fd4f097b504d25c6350d7a93.

css: updated postprocessed files.

css: ability to inflate spacing of .m-table by putting .m-big on it.

css: properly restrict styling to tables marked as .m-table.

css: ability to put .m-thin on <th> elements.

css: ability to align text vertically in a table cell.

Ability to show list of latest news on the index page.

site: update index page styling.

I'm overusing this thing.

site: added favicon.

theme: ability to specify a favicon.

doxygen: ability to specify favicon.

doxygen: name the function better.

doc: link to live version of the Doxygen theme.

doxygen: make it possible to override top navbar links.

doxygen: remove M_SHOW_DOXYGEN_VERSION setting.

Was used only for testing, can be supplemented by modifying
M_PAGE_FINE_PRINT.

doxygen: make it possible to hide the footer altogether.

Makes testing much easier.

doxygen: test overriding properties, not hiding them, in layout test.

doxygen: test layout with minimal Doxyfile.

theme: support for archived articles.

theme: different styling for updated articles in the footer.

m.dox: some patches to make this work with the cppreference tag file.

Added flat button style.

css: separately configurable value for button background color.

In particular, had to use a darker color than the default background
color of the dark theme as the contrast was too little with danger and
info buttons.

css: At least some padding on full-width buttons.

When tucking the full-width buttons in a table that had many columns
there was no padding at all, looking extra ugly.

css: removed min-width of header menu sub items.

Caused horizontal scrollbar when the rightmost item had a submenu. Now
it's a bit ugly, but at least without the scrollbar.

css: make also the bottom rounded on flat figures.

It looks weirdly cut off when there is no border.

css: figure border radius should be configurable as well.

css: updated postprocessed files.

css: for some reason div.m-scroll was missing from here.

css: rework button markup.

Default to centered button, because that's what one usually wants. This
also resolves the problem with the following markup not having spacing
after and thus being too sticky to content that immediately follows it.

    <div class="m-text-centered">
      <a class="m-button m-success" href="#">...</a>
    </div>

The new markup is thus this, the .m-text-centered class no longer
needed. Adding .m-fullwidth to the <div> works as expected.

    <div class="m-button m-success">
      <a href="#">...</a>
    </div>

Sorry for potential breakages of your content.

site: updated footer.

No silly jokes anymore. THIS IS SERIOUS SHIT, YA?

doxygen: improve diagnostic output.

Not printing info about every file in the default case anymore, printing
just the warnings. In order to make that usable, all warnings are now
prefixed with name of file that's being processed.

Documentation goal, like with stock Doxygen, is to have zero console
output.

css: updated postprocessed files.

css: better color for cover image background.

The previous was too much grey and too little blue.

css: improved styling for landing page title.

It's a bit bigger now, with some more padding around and a possibility
to control its casing.

css: fix jumbo article header behavior on very narrow / very wide screens.

In some cases the content after got floated right after the article
title, on iOS Safari the content was even overlapping the header. Also
added a minimal font size so the (sub)title and date/author text don't
get scaled below 1rem.

Now the cover image also slides a bit under the summary / content, like
it is on landing pages.

package/ci: use Doxygen 1.8.14 on Travis.

Update copyright year.

doc: Doxygen 1.8.14 with all the patches was released.

m.dox: not just pages can have sections.