documentation/python: improve error reporting in pybind signature parser.

The exceptions were mostly there, but the text got lost at the end!
Silly.

documentation/python: expand pybind default enum argument tests.

To verify also a case with an enum nested in a pair (which won't get
linked to because we're not *that* advanced yet).

documentation/python: typing.Generic.__new__() is gone in 3.9.

documentation/python: implicit TypeVar for typing.List was only in 3.7/8.

If I say typing.List, only Python 3.7 and 3.8 converted that to
typing.List[T], 3.6, 3.9 and 3.10 keep typing.List.

m.qr: actually, the difference is *also* due to Python versions.

Somehow the attributes have different order, generating a MONSTROUS
difference.

Heh! Why! Why do I have to suffer this much all the time.

package/ci: haaaaaaaaaaaahhhh docutils also.

Just half a day and I already miss the stability of C++ development.
FFS.

m.dot, documentation/*: use graphviz 2.44 output for 2.42.2 also.

Hope this finally makes the CI pass.

package/ci: use older Pygments until I update the test files.

package/ci: use older qrcode package until I update the regexes.

package/ci: drop Python 3.5 testing, add 3.8 to 3.10.

Python 3.5 was EOL'd in September 2020 and support for it is being
removed from major packages like pybind. It was also the only version
on which neither the Doxygen nor Python doc generator worked due to lack
of typing annotations, and since those two are the major use cases, I
don't think there's many users relying still on 3.5.

Python 3.6 was EOL'd in December 2021 so *technically* I could drop it
as well, however Ubuntu 18.04 LTS still has it as the default version so
it's good to keep it. I don't really need to use any 3.7-specific
features yet either, so this isn't a problem.

pelican-theme, m.code, m.dot: make stuff finally work on Pelican 4.5.1+.

Since Pelican 4.5 moved to "namespace plugins", the way plugins are
loaded is different and thus the root plugins/ directory is not in PATH
anymore, leading to errors like

    No module named 'ansilexer'
    No module named 'latex2svg'

After spending a bit of time looking into how "namespace plugins" are, I
decided to stay with what they say "legacy plugins" because that doesn't
require me to move everything into a pelican.plugins namespace and thus
allows me to reuse the exact same file for plugins to other m.css tools
like the Python doc generator.

Version 4.5.0 had loading of namespaced plugins (the `m.` here) broken
completely, which is why the CI got pinned to 4.2. With 4.5.1 it started
working again and due to how the tests were executed the PATH issues
weren't hit either, leading me to a false sense of security that
everything works again on 4.5.1, while it wasn't. This fix is the final
piece to make everything work again. Sorry that it took over a year to
get in.

Co-authored-by: Lukas Pirl <git@lukas-pirl.de>

m.plots: fix a deprecation warning with matplotlib 3.5.

It complains that "Support for setting an rcParam that expects a str
value to a non-str value is deprecated since 3.5 and support will be
removed two minor releases later."

documentation/python: minor.

Those values are already available, so don't calculate them again.

doc: clarify the same for m.images default options.

doc: not everyone may like hyphenation or smart quotes.

Plus hyphenation requires extra packages, so don't suggest it by default
-- but clarify that those actually *are* the defaults and so the user
can omit them.

documentation/python: ensure all plugin hooks are always tested.

documentation/doxygen: recognize also <s> and <del> tags.

Followup to 12e0081a093ecf5e9dc287c549b4b521d45a2b6b.

documentation/doxygen: allow \xrefitem with numbers in the middle.

In Magnum I used to have \xrefitem aliases such as \requires_gles20 so
the current regex worked, but when adding \requires_gles20_only it
didn't work anymore. Such a stupid oversight, sorry to whoever else
tripped up on that as well.

Not updating any test case because regexes are write only anyway.

doc: mention m-clearfix also for floating elements.

That's where people will use it the most. Funnily enough the clearfix
already had to be used in the markup, so that's one more reason to
just put it directly in the snippet.

doc: clarify naming for such an important option.

Even I don't remember how it's meant to be named anymore, sigh.

package/ci: NOTHING IS EVER SIMPLE.

G'damit, can I just make the test run first *and only then* go on with
upgrading all the shit that broke in the few months while I was not
looking?!

package/ci: run tests verbose so it's clear what got skipped.

package/ci: install attrs as well.

Got a slight drop in coverage due to that.

m.dot: update graphviz 2.40 ground truth file.

I'll just assume it's correct.

package/ci: eugh everything is an unstable pool of mud.

package/ci: migrate to CircleCI.

Thanks, Travis, for being silent for three months straight. Fuck that
"service".

Add .yml files to .editorconfig.

m.htmlsanity: drop Flash-related code and fix compat with docutils 0.17.

That thing is DEAD so there's no reason to bother. This changed in
docutils 0.17, making the current version fail there. Funnily enough,
https://github.com/live-clones/docutils/commit/659c3f1e46f0c86609936c987b7e2a7a6ef89cb2
looks like they still seem to preserve that somehow. I won't, so all the
related code isn't needed.

The code here was originally taken from docutils but diverged
significantly and given that they still use the deprecated width/height
attribute I see no reason to even attempt cherry-picking their changes.

m.dot: support subgraphs.

documentation/doxygen: add a human-readable assert here.

Update CREDITS.rst.

Simplify formatting of ANSI-highlighted code

Omit superfluous g-AnsiDefault, g-AnsiBackgroundDefault classes

Add missing background styles

Correct comment regarding bright background colors

doc: update outdated Doxygen version requirement notices.

package/ci: go back to Pyphen 0.9.5.

As usual, every upgrade of every package breaks something.

Updated CREDITS.rst.

Update pagination Pelican template.

The template was hardcoded for the default reversed date ordering of
articles.

Fix doxygen base path resolution.

Use top-level doxygen path as base path. In case of recursive descent,
don't allow base path to be overriden.

doc: cross-link the Doxygen Show Undocumented option from more places.

doc: document what to do in Doxyfile for nice graphviz look.

Doc++

Point to travis-ci.com instead of .org also in the README.

documentation/doxygen: don't create output dir if it's empty.

It doesn't make sense to me why makedirs() wouldn't just gracefully
no-op that.

build-status: migrate to travis-ci.com.

Wait, don't tell me it's *this* easy.

doc: fix another order-dependent processing error.

Updated credits.

Fix import errors in plugins

Fix #178

m.plots: update the regex hell for matplotlib 3.3.

package/ci: go back to Pelican 4.2 until I find a fix.

OH GOD, one can't just leave a project alone for 6 months because every
damn thing just breaks, changes or gets removed. Kids these days, FFS.

Imagine if the standard of electrical outlets changed rapidly every two
weeks, you'd just have to constantly buy new fucking adapters and you
would HATE it. So why is it COMPLETELY FINE with software?!

package/ci: download doxygen from elsewhere.

I don't have time to plow through new bugs in 1.8.18, 19 and 20, so
DON'T delete the old versions FFS.

Adapt to Pillow 7.2 changes

doc: updated credits.

Fix padding in function names

Co-authored-by: Cris Luengo <cris.l.luengo@gmail.com>

Fix search input focus loose on autocompletion by tab

documentation/python: improve an assert.

m.images: improve a failure message.

documentation/python: pile on more workarounds for typing.Union.

SIGH.

documentation/python: explicitly test for string type annotations.

No surprise expected, just to have that here.

documentation/python: define an environment variable when generating.

I need that for some REALLY DIRTY hacks.

doc: turn the Python monkey-patching docs into a first-class section.

doc: fix a broken link.

Interesting that Pelican doesn't complain here.

css: make figcaption follow the heading decoration rules.

So if I have all heading links not underlined, this one is neither.

Fix typo in closing tag name

pelican-theme: better align tags on jumbo articles.

With a large amount of tags (like on magnum.graphics) it was uglily
misbalanced. Now it should be better.

m.plots: allow to specify plot width also.

m.plots: change :labels_extra: and :bar_height: to dashes also.

It was UGHLY also. The previous option name is still recognized, of
course.

m.code: support :hl-lines: in the .. include:: directive as well.

Not sure why original Docutils didn't have that.

m.code: change to :hl-lines: instead of :hl_lines:.

I can't stress how much I hated the underscore. Turns out it's there
ONLY because Pygments have an underscore, otherwise there would be a
dash like with all other directives/options/roles. Eh.

The legacy option is still recognized of course.

css: improve code highlighting for string escapes and interpolation.

And test this look via the m.code plugin.

documentation/python: list forgotten default option, avoid duplicates.

documentation/doxygen: doc++

Fix renamed option use

documentation/doxygen: add an ability to run filters on code.

Finally I'm able to generate Magnum docs without a hastily patched
m.css to convert color literals to color swatches. Ugh this took ages.

documentation/doxygen,m.code: unify code whitespace stripping.

For some reason due to an accident m.code wasn't strip leading
whitespace in inline code. Of course no test caught this.

documentation/doxygen: put deprecated label after final/virtual label.

To be consistent with the order in class index pages. Doesn't affect any
tests (which is fine).

documentation/doxygen: parse inline namespaces.

documentation/doxygen: don't set is_final=False for non-classes.

documentation/doxygen: forgot to add final label on nestable classes.

documentation/doxygen: preserve template info in base classes.

documentation/doxygen: haha what.

documentation/doxygen: clarify a bunch of things.

documentation/doxygen: reduce boilerplate in the tests.

Followup to 5eb113bae33b05701b8e213d2400298ada29138e.

Updated CREDITS.rst.

m.code: revamp ANSI color code handling completely.

Co-authored-by: Sergei Izmailov <sergei.a.izmailov@gmail.com>

m.code: remove the ZWNJ hack.

Was used only to fix one browser rendering issue on magnum.graphics
which happened only when Unicode blocks were involved. Does not make
sense to pollute all output with it.

documentation/doxygen: detach the console highlighting symlink.

The ANSI lexer is getting a massive update, and we don't need to test
the whole thing twice.

m.code: add .. code-block:: and .. sourcecode:: aliases.

doc: yet another order-dependent generation issue.

Updated credits.

documentation/doxygen: fixed bug with exception references.

documentation/python: prefix an internal utility function.

documentation/python: add Iterable to recognized typing types.

documentation/python: make `parse_pybind_type` more permissive.

pybind11 has some non-standard typing-like annotations, e.g.:
List[List[float[3]][3]] for std::array<std::array<float,3>,3>

documentation/python: improve pybind11 default argument parsing.

documentation/doxygen: switch to a config supplied from a Python file.

Keeping full backwards compatibility with the original Doxyfile names,
except for template files which now have to use the new values.

doc: clarify some more Doxygen (mis)behavior.

Updated copyright year.

Fix typo