doxygen: explicitly save symbol count.

With all the aliases the autodetected number was quite off.

Doc++

doxygen: implement \m_keyword, \m_keywords and \m_enum_values_as_keywords.

doxygen: support for aliases in search.

Not yet wired to the complete doxygen extraction, though.

doxygen: every item added to the map should have proper type.

doxygen: save search data size as bytes.

doxygen: simplify search (de)serialization code.

doxygen: save some bits.

doxygen: add compound to search data during the actual parse.

So it's prepared for adding extra search stuff that needs to be parsed,
such as search keywords.

I went through the test case and manually reordered by hand to ensure no
functionality was lost while doing this. It was not, quite the opposite
-- groups were not properly marked as deprecated. Now they are. The file
size stays the same, as it should.

doxygen: verify size of search data in the integration test.

doxygen: add functions twice to the search data.

With the breadth-first traversal for search result gathering we need to
handle two things:

 1. Show a function named min() among other three-letter names (such as
    BlendEquation::Min), so in fact have it just as "min" in the trie.
 2. But make it still possible to search for min() with the parentheses
    after in order to filter out non-function results, so in fact have
    it *also* as "min()" in the trie.

This required that the result prefix merging was updated to allow
self-referencing (an item being a complete alias of another item).
That's now allowed only if the suffix length differ and is allowed only
from one side to avoid a cycle. Suffix length differs, because one
result has the () suffix while the other hasn't.

In order to prevent the function from appearing twice in the results, a
lookahead barrier is added to the ( character. That was nicely simple.

doxygen: avoid trailing spaces in search pretty-print.

doxygen: sort globbed files when testing.

Makes the results predictable. Wasn't a problem before, but now the
search results are indexed based on that.

doxygen: huh why are the hashes completely different again?!

doxygen: implemented result map prefix merging.

doxygen: there will never be more barriers.

doxygen: stupid Doxygen.

What the fucking shit.

doxygen: gathering search results breadth-first.

Instead of depth-first. So the shortest results are first.

doxygen: save result count instead of node size to search binary.

Makes the code much simpler and allows for up to 256 children and 256
results in each node, instead of limiting its size to 512 bytes (thus
e.g. 64 children and 127 results or some other combination).

I like it when things get better, more flexible and simpler by removing
a bunch of complicated code.

doc: updated Doxygen docs.

doxygen: propagate function deletion status to the search.

Also renamed the internal flags to be less annoyingly long.

doxygen: extract deprecation info and show it everywhere.

 * In symbol/filesystem tree listing
 * In member listing
 * In the search

doxygen: don't show dirs with / at the end in search.

Not needed since we have the type labels now.

doxygen: disable unneeded Doxygen output in tests.

doxygen: avoid wrapping the top navbar on small screen sizes.

Now with the search button it's a bit more crowded.

doxygen: include symbol type in the search data.

css: styling for Doxygen search result labels.

doxygen: make search lookahead barriers and subtree merging configurable.

So I can see the difference.

doxygen: improve the trie pretty print flexibility, add colors.

I'm using that for the blog post, so it saves me some time :)

doxygen: proper UTF-8 support in search.

doxygen: show count of found results and search time.

doxygen: prevent page scroll (and layout jumps) on showing search.

doxygen: implement lookahead barriers for search.

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.