doxygen: if the URL already contains #search, hide scrollbar etc.

For consistent experience compared to loading the docs without #search
and then hitting Tab.

doxygen: behave consistently when going back to filled search input.

Not sure why I didn't use the same implementation in both cases.

doxygen: debug output for long-running tasks.

doxygen: disable spell check in the search box.

doxygen: prevent search result being selected before the mouse moves.

Without this, the search was quite unusable with just the keyboard.

doxygen: provide a more meaningful order for results.

Results of the same length are now ordered like this, instead of
appearing in whatever order they were added:

 * Deprecated and deleted symbols are put on the bottom
 * Then ordered by type:
   * First pages, since they usually provide most information
   * Then namespaces and groups
   * Then classes, structs, unions
   * Then functions
   * Then macros
   * Then enums
   * And enum values and variables last
 * After that, items with the shorter suffix (the least amount of
   function arguments) are preferred over longer
 * Finally, items with shorter prefix are preferred over longer (so e.g.
   it shows a Foo in the root namespace over Foo which is 5 levels deep)

This might get fine-tuned later, but I'm already very happy with the
result.

doxygen: swap order of search-related class definitions.

So I can type-annotate better. No functional change.

doxygen: parse override, final and conditional noexcept keywords.

 * override and final is now parsed from function signatures, in the
   theme the [virtual] label gets replaced with either [override] or
   [final], since it doesn't make sense to include both [virtual] and
   [override]/[final] label as the former is implicit for the latter.
 * fixed order of parsing function signature keywords so function
   signatures that are both deleted/defaulted and noexcept are parsed
   correctly instead of noexcept being ignored
 * conditional noexcept is now recognized as well, shown in the theme as
   [noexcept(...)]
 * [final] class specifier is now shown in the class header and also in
   the derived class list
 * [virtual] label is now shown for both virtual base class and
   virtually derived classes to make it symmetric

Updated copyright year.

doxygen: more detailed docs explaining the #include behavior.

And required patches.

doxygen: improve #include information display based on real-world use.

 * In cases where Doxygen spots the namespace first in a *.cpp file (and
   later in a header) but the namespace is still contained in a single
   header, the include informations was improperly put locally into
   members, instead of globally. Now the information is propagated
   upwards from the members to ensure correctness. This needs also
   special handling for namespaces that are otherwise empty, where
   there's nothing that could propagate the info upwards.
 * Complex namespaces (namespaces containing other namespaces or
   classes) no longer have the include information global even though
   the non-class/namespace members are in the same file. This would be
   misleading since inner namespaces and classes are often in different
   files.

doxygen: of course I hit an issue right at the start, so let's test it.

This breaks everything.

Populated CREDITS.md.

doxygen: explicitly write trailing newline to all output files.

Makes test file updates much easier. I need to revisit this later with a
more systematic solution.

doxygen: show corresponding #include files.

This is again a superset of the functionality that stock Doxygen
supports (well of course, I'm full-assing things as usual):

 * Classes (structs, unions) show their corresponding include file right
   in the header (that's what Doxygen does, too)
 * Besides that, namespaces that are fully contained in one file show
   the corresponding include file as well
 * In case of modules (groups) or when namespace contents are spread
   over multiple files, each member shows its own specific include file
   in the detailed docs (because not doing that would be very confusing
   for users, especially if the mapping to files is not trivial). This
   means that functions/enums/typedefs/variables/defines that were
   previously just a brief docs may now get expanded to full docs just
   to contain the include file information. This also unfortunately hits
   a bug in Doxygen, where it doesn't properly report the header
   location for declarations of free (non-member) functions and
   variables (but uses the definition location, which is in most cases
   in an (otherwise undocumented) *.cpp file). I need to report and/or
   PR that, ugh.
 * Files don't provide the include file information, because there it's
   known implicitly.
 * The SHOW_INCLUDE_FILES setting (which defaults to YES and is meant
   to be for "a list of the files that are included by a file in the
   documentation of that file" which is just absolutely fucking useless
   in every way imaginable) is reused to toggle showing of the include
   information.
 * To make the rendering a bit more compact, in case the struct or
   member contains template parameters, the include information is put
   next to these instead of after the signature.
 * As with everything else in m.css, if the corresponding header is not
   documented at all, the include file information is not present.

The \headerfile Doxygen command is not supported, because (what
a surprise! this is totally shitty as well! who would have thought!):

 * it works only for classes, you can't override the include name for
   the file itself!
 * and forget about doing anything like that for free functions,
   typedefs or the like!
 * (minor) it doesn't support #include A_MACRO
 * it doesn't seem to be exposed in the XML at all (ahahahahah AAAARGH)

Co-authored-by: Ryohei Machida <machida_mn@complex.ist.hokudai.ac.jp>

doxygen: print #define detailed description only if actually there.

The detailed docs can contain just parameter docs, for example.

doxygen: support C++14 variable templates.

Interestingly enough, Doxygen already has the support and I just need
some basic template bureaucracy to get it running.

doxygen: minor update to the namespace page template.

There will be an include line added and this is sufficiently
self-contained to commit separately.

doxygen: minor code clarifications.

css: make it possible to have also inline code inverted and highlighted.

More of a hack to support Doxygen theme #include info styling.

doc: forgot to document typedef.has_template_details doxygen template.

Doc++

package/ci: use Doxygen 1.8.15.

Finally, a year later, a stable release I can use for testing on Travis.
On the other hand I'm furious because the old FTP got lost along with
all files it had and now the only possibility is to fetch infested crap
from sourceforge.

Also UGH WHY SO SLOW.

doxygen: adapt for xrefitem anchor changes in 1.8.15.

doxygen: <hr> is a block element.

Also remove a comment and check that made sense before suupport for <hr>
was added.

doxygen: some awful autobrief stuff actually got fixed.

But it's still a dumpster fire.

pelican-theme: nope, this is not merged yet.

doxygen: adapt to renamed Doxygen option.

doc: fixes for order-dependent RST parsing errors.

m.math,doxygen: another case of math rendering in different order.

Similar issue appeared in c327de907e1de101636f7b3e5697eda6416902e8, what
that hell is causing this?! Is it because I ran updmap?! Is that shit
not deterministic?! What the hell?!

doc: mention all required latex packages for math rendering.

Remove test files for dot 2.36, not needed anymore.

m.plots: Travis with 16.04 doesn't have this bug anymore, it seems.

package/ci: try to use Doxygen 1.8.14, finally.

package/ci: use Ubuntu 16.04 on Travis.

doxygen: slightly more robust way of parsing template arguments.

I don't want to parse C++, please don't ask for more.

doxygen: add back removed spaces around &&.

And test this whole thing.

m.htmlsanity: clarify the use of expand_links a bit.

I wanted to remove it at first, but then realized a more proper solution
would be to not require the user to add random fields to
FORMATTED_FIELDS. In the ideal case the template *could* do just

    {{ field|render_rst|expand_links(article }}

but at the moment Pelican strips all reST formatting from the
non-formatted fields, which kinda prevents this. So keeping the filter
for later when we have this fixed.

doc: mention that Pelican 4 is required.

theme: this PR is not merged yet.

theme: use the {slug} instead of %s for feed URL templates.

And thus dropping Pelican 3.7 support here as well.

m.htmlsanity: drop Pelican 3.7 compatibility.

A huge pile of ugly workarounds. NEIN.

doxygen: properly bubble up search keywords from lists as well.

doxygen: test propagating \m_keywords from a list.

Noope.

doc: more fixes to order-dependent reST errors.

Add license badge to README, reorder them for consistency.

Added .editorconfig to control indentation across various files.

And replacing .kateconfig with that.

Adapted to Pelican 3.8 {filename} -> {static} changes.

doc: I got to learn more dot, so clean up the sources.

doc: fix more cases of order-dependent processing error.

css: correctly color links inside block headers.

css: renamed --color-button-active-color to --color-link-active-color.

This will get used for more things than just buttons, so the name is
quite misleading.

css: move color setup to one place in the file.

doxygen: make it possible to override styling of all blocks.

Finally I can have custom xrefitems.

m.filesize, m.images: support Pelican 3.8 {static} placeholder.

Remove old Pelican stuff that's no longer needed.

Updated .gitignores to hide testing stuff.

m.dox: support adding custom classes to the links.

m.dox: properly clear everything on init().

It's not usual that init() is called more than once. Except in tests,
there it breaks stuff.

doxygen: support the \htmlinclude command.

doxygen: properly fill error message placeholder.

doxygen: allow both <para> and <mcss:div> be parent of block elements.

css: improve the debug style a tiny bit.

doxygen: handle code/formula block/inline distinction always.

And not only when these are in paragraphs -- we can wrap them in a
m.css-specific tag and this would break. There should be no visible
behavioral change with this.

site: enable debug CSS for local development.

css: support color swatches in code snippets.

Still needs to be hooked into Pygments, m.code and Doxygen theme
somehow.

css: fix padding-after for SVG images.

:(

css: reworked support for floatable components.

What's done, roughly:

 * It's now possible to tuck the floating components out of the page
   flow similarly to .m-container-inflate. This required me to update
   the active section highlighting to handle this case correctly as well
   (and there's a lot more CSS for that now, ugh).
 * The .m-container-inflate has now padding after to make it better
   integrable into everything else.
 * OTOH, the all-around padding for .m-col-*-* elements is done only
   when they are direct children of .m-row. Otherwise, the padding is
   done only for .m-left-*, .m-right-*, .m-center-* and only on sides
   where it is needed.

Also added a few tests for functionality that was neglected before.

Add the light color theme source as well.

HTTPS links to external sites as well, if possible.

mcss.mosra.cz is HTTPS now.

Other parts of mosra.cz not yet, as I don't want to bother with broken
design due to the outdated theme right now.

Magnum has HTTPS now.

m.htmlsanity: don't choke on links without refuri.

Sorry :(

doc: fix Doxygen snippet.

What was I doing there?!

m.htmlsanity: don't apply typography on links with URLs in title.

And e-mail addresses. That's a very bad thing to do.

css: highlight also diff subheadings.

artwork: update the theme file with diff highlighting colors.

css: implement diff colors for the Pygments dark style.

Doc++

doxygen: implement support for \dot and \dotfile.

Ugh, this blew up again. Three days to get here.

doxygen: delimit inline CSS with a semicolon for consistency.

doxygen: fix parsing of two consecutive HTML navbar links.

Of course I have bugz!

m.dot: compatibility with graph figures from m.components.

m.dot: make title optional.

Requiring a title won't make any sense for graph figures.

m.dot: extract the reusable guts to an independent module.

Will get used in the Doxygen theme, where we don't need docutils or
Pelican.

m.math: compatibility with math figures from m.components.

m.math: process all math in the directive at once.

Having multiple blocks is not very useful, as you don't get any of the
fancy typesetting features for that. Use latex arrays for that or
put the math into multiple consecutive directives.

m.components: support math and graph figures, figure captions.

The m.math and m.dot plugins need to be updated as well, to put the
<svg> directly inside instead of wrapping it in a <div>. THat'll get
done in later commits.

css: enforce bottom padding on figures w/ components in description.

Otherwise stuff like `div.m-graph:last-child` that resets it back to 0
gets a priority.

css: make it possible to have math and graph figures.

Also added a test file verifying math coloring priorities.

css: make graph, plot <svg>s and block math <svg> a block element.

It was inline, which caused weird padding on the bottom.

css: ensure parity between <img> and <svg> for images and figures.

css: have padding-after also for plots and graphs.

Not sure why this was omitted.

doxygen: make it possible to have separate brand link in navbar.

css: make it possible to have a main/subsite link in the navbar.

theme: ability to create pages with a passthrough template.

I.e., without any header navbar or footer.

theme: make it possible to add JS files and arbitrary HTML to page head.

doxygen: support arbitrary HTML for navbar links.

doxygen: remove redundancy from test names.

doxygen: support adding extra stuff to HTML <head>.

There's a new option for that: M_HTML_HEADER. Specify it as a multi-line
value for extra prettiness.