css: use concrete font weight value.

I'm using semibold version of Source Sans Pro, which is 600, not 800.

css: make code font size configurable from the theme.

Not every combination of font and monospace font works with scaling the
code to 0.9 -- the light theme has base font size only 14px and there
the code would be too small. Also use `em` instead of `rem` so it
follows surrounding text size.

css: properly handle variable declarations with comments in postprocess.py.

doxygen: don't crash on anchors with IDs that don't match the compound.

m.components: provide roles for labels.

I got extremely tired of writing this myself *every time*.

css: strip trailing comments also for lines with variables.

I am back at 8.9 kB, yay!

Make the latex2svg caching fully optional.

css: separate page layout styling out from m-components.css.

For the presentation framework I need the responsiveness,
typography, components but definitely not popup menus or jumbo article
styling. So away it goes, into a new m-layout.css file.

This also means the theme setup is now in a separate m-theme-*.css file
and the m-dark.css / m-light.css is just a "driver file" that imports
everything else. There will be a m-dark-presentation.css /
m-light-presentation.css driver file as well.

css: reduce excessive line length.

css: deduplicate parser code in the CSS preprocessor.

No change in the output (which was desired).

Exclude the third-party latex2svg.py from code coverage.

Include general symbols for math rendering.

I needed that for the \degree symbol.

Implement caching of rendered math output.

Stores the output of divsvgm in a dict and (de)serializes that in the
filesystem to preserve it across runs. Rough speedup:

 * For the Magnum website, initial generation went down from 14 seconds
   to 9, with subsequent runs just 2.5 seconds.
 * For the Magnum docs, generation time went down from 1:33 to just 14
   seconds.

m.math: properly reset formula counter on page breaks.

Otherwise the output was not deterministic anymore.

doxygen: warn if included code snippet is empty.

Very useful since Doxygen stays silent in this case.

plugins: new m.vk plugin.

plugins: avoid dependency on __init__.py for simple link plugins.

Duplicated the common code over. It's fully covered, so it's okay.

doxygen: mention that block-level \m_class has to be separated by a
newline.

I *really tried* to make it work, but it was not worth the pain.

doxygen: <image> doesn't have to be always in <para>.

m.code: don't blow up if inline literal doesn't have language.

doxygen: implement <small>.

doxygen: implement <hruler/>.

doc: include client search tests in Build Status.

doxygen: support \section etc. in function documentation.

Not rendered into <section> tags as that breaks the style, it's just
basic <hX> tags. Also ensuring that \param, \return etc. are propagated
from there.

doxygen: minor cleanup.

doxygen: proper <hX> hierarchy for headings in non-top-level description.

Also don't emit the \section warning for these, it does not make sense.

m.plots: matplotlib otherwise keeps everything in memory.

Huh.

m.plots: work around test failure on Travis.

Only one ID is different, which is still okay to validate a separate
test case.

m.plots: make the font configurable so we can pass the CI.

m.plots: matplotlib uses X by default?!

package/ci: install matplotlib.

plugins: new m.plots plugin for rendering inline SVG plots.

doc: fix breadcrumb.

doxygen: be nicer to KDevelop syntax highlighter.

doxygen: verify that latex blow up is handled properly.

plugins: properly print error from latex2svg when something fails.

doxygen: don't crash during search building on too long function arguments.

In some very pathological cases the function parameter list might exceed
256 characters, which won't fit in the serialized data. But that also
won't fit in the search result list so there's no point in storing so
much. Truncating to 65 characters and adding an ellipsis after.

doxygen: make KDevelop higlighting happier.

doxygen: fix crash with class inheritance outside of a namespace.

Amazing that I didn't come across this until now.

doxygen: bundle a matching favicon by default.

plugins: new plugin m.alias.

doc: highlight the Doxygen search functionality a bit more.

theme: render the draft status in article footer.

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.