doc: mention the m.css Doxygen theme in m.dox documentation.

m.dox: make it possible to link to arbitrary anchors.

Yes, this would clash with anchors inserted by Doxygen itself, but that
use case doesn't make any sense anyway.

doxygen: avoid needless dependency on Pelican and docutils.

These were pulled in transitively from m.math and I was not aware of
that. Sorry. Now it's just jinja2 and Pygments needed, as documented.

doxygen: properly support CASE_SENSE_NAMES set to NO.

I was working around the indexpage/index name mismatch by using
<compoundname> for pages, but that doesn't work well when
CASE_SENSE_NAMES is disabled. This fixes it.

doxygen: implement table caption parsing.

doxygen: don't crash when encountering sections with _1 in them.

doxygen: use state.current_compound.url instead of state.current_url.

Makes it more flexible for future additions.

Doc++

doxygen: JAVADOC_AUTOBRIEF is... wow. I need to take a shower.

Or, don't blow up on an unfortunate series of bad events.

1. If a file has a copyright header starting with /// and delimited with
   **** and JAVADOC_AUTOBRIEF is set to ON, Doxygen treats the first ***
   line as a brief documentation, which then made m.css fail because it
   doesn't expect stuff like <para><hruler/></para> inside
   <briefdescriptions>. The <hruler/> is still not implemented yet,
   though.

2. Who would have thought that

       /// A brief docs.
       /// @{
       /// Some detailed docs.

   would be understood as a two-paragraph brief?!

3. And who would have thought that

       /// ============
       /// The Thing
       /// ============

    would create a brief containing some === characters and a <heading>
    inside?! Here I just give up and ignore the whole thing.

doxygen: actually, just abort when CREATE_SUBDIRS is enabled.

doxygen: it's CREATE_SUBDIRS, not GENERATE_SUBDIRS. Stupid me.

Treat *.h files as C++.

Make the GitHub language bar prettier.

doxygen: warn if GENERATE_SUBDIRS is enabled.

doc: minimal Troubleshooting section for the Pelican theme.

doc: a new Troubleshooting section for the Doxygen theme.

So I don't have to repeat myself :)

doc: more prominent link to the Doxygen theme "demo".

doxygen: fix <h2></h3>.

Amazing when such a glaring issue gets unnoticed in hundreds of test
files.

doxygen: minor cleanup.

doxygen: implement support for the \exception keyword.

doxygen: verify that \param etc. is extracted out of a list as well.

Previously this was asserting because I didn't expect Doxygen to be so
shitty and put these *inside* of some random list without ending that
list first. This also uncovers a lot of other nasty Doxygen bugs, so I'm
just creating a very restricted repro case that doesn't trigger them.

I lost all hope with Doxygen. Kill it with fire and start over.

doxygen: safety assert so we don't miss \retval that's in weird places.

Missed that when implementing \retval support in
5e6d0bcaae00412c3acbd371f11ef6276af6d0b9.

doxygen, m.math: update math rendering tests.

For some reason the paths are in a different order now.

doxygen: prevent particular Doxyfile values from becoming empty.

In particular the HTML_EXTRA_STYLESHEET, which is set to empty by the

    doxygen -g

generated Doxyfile.

doxygen: be more failproof for depth attribute returned from dvisvgm.

Sometimes the regex doesn't match and returns None, even though I tried
reaallyy hard to make it match. This fixes it for good.

doxygen: make it possible to highlight Jinja templates.

There's no well-known extension for these and Doxygen \code{.ext}
*requires* an extension inside {} otherwise it blows up.

doxygen: don't crash when encountering xrefs in the form of @_1@.

Triggered by Android NDK docs.

Build status avoid jumpy relayout when loading.

Build status: no point in showing long stuff like 117 minutes.

doxygen: don't mark things containing \bug as deprecated.

Ugh am I stupid?!

doxygen: the search might lead to the same page, so restore the scrollbar.

doxygen: eat T / Tab only if no modifier keys are pressed.

Otherwise Ctrl-T and Shift-Tab for opening a new / going to another tab
don't work as they should.

doxygen: improve the search help text.

doxygen: count also all aliases to the search symbol count.

doxygen: minor cleanup.

doc: \section commands elsewhere than top-level docs are not supported.

The visual layout is not ready for such thing at all.

doxygen: propagate keywords from inside sections as well.

doxygen: minor cleanup.

doxygen: go back in history when closing search.

Instead of polluting it even more. Makes back button and context
preservation behave much better now.

doxygen: render the aliases in search better.

In particular it's more important what's the alias than what's the name
it points to.

doxygen: properly bubble up also enum-values-as-keywords from sections.

doxygen: properly bubble search keywords from sections upwards.

doxygen: test that search keywords inside sections are bubbled up.

They aren't.

doxygen: test another case of result URL merging.

This time min() on line 279.

doxygen: this is not needed, it was tested elsewhere.

doxygen: fix heavily nested result URL combining.

The test passes again.

doxygen: test that nested namespaces have the URL properly combined.

They don't.

doxygen: document why a test is skipped.

doxygen: support rendering namespace members in file scope.

doxygen: properly qualify base/derived classes in other namespaces.

Previously the prefix was unconditionally omitted, which is confusing in
case a class from one namespace derives from a classs in another
namespace.

doxygen: be more strict when parsing symbol IDs.

In particular, expect that symbol ID base URL is the same as base URL of
the enclosing compound. If that's not the case, there's something wrong
and docs for it should be generated elsewhere.

doxygen: be compatible with stock HTML output for undocumented symbols.

In particular, if given compound has neither brief nor detailed docs,
produce output for it only if it's a page or a group (because those need
to be explicitly created). Before only file/dir docs behaved like this,
not namespaces or classes.

doxygen: don't populate search data when search is disabled.

doxygen: explicitly encode all output files as UTF-8.

Fix encoding error on Windows

doxygen: implement remaining kinds of section commands.

In particular:

 - \author, \authors, \copyright
 - \version, \since
 - \date
 - \pre, \post, \invariant
 - \par and RCS entries (`$Id: something $`)

The \par is now also able to append to previous sections of any kind if
its title is omitted.

doxygen: hide unreachable code from coverage, remove old debug output.

doxygen: support the \retval command.

doxygen: kill dead code.

doxygen: use python3 executable for more scripts.

Use Python3 executable, instead of Python

macOS & Linux define the Python executable to be Python 2.x, and since
dox2html5 does not work with Python 2.x, explicitly use the Python 3.x
executable to ensure it's working.

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.