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

Updated CREDITS.rst.

pelican-theme: wrap page/article content in blocks.

For easier extension/customization/overriding of templates.

m.code: add a bunch of advanced .. include:: features.

It was already useful, but this makes it even more. What's done:

-  :start-on: so it's possible to pin on something in the code without
   having to add a comment marker everywhere
-  :end-before: that can be empty, and thus simply stop at the end of
   the block
-  :strip-prefix: for removing excessive indentation as well as adding
   an ability to interpret code comments as reST.

All combined together, one can now embed Sphinx Gallery files (which can
be converted to ipynb files too) *and* still have a total flexibility
over what's done on the content formatting and layouting side, ignoring
boring portions of the source file etc etc.

m.code: take over the whole .. include:: directive.

Until now it was overriding it only if the :code: option was present,
but I need to extend it also for direct include, so copying over the
whole implementation from docutils. And removing the :encoding:,
:literal: and :name: options as I don't see any use for them nowadays.

doc: mention the :filters: option earlier.

documentation/doxygen: support CSS classes on table cells.

Finally.

Revert "wrap page/article content in blocks"

It's actually completely broken, GitHub led me to a false sense of
security by showing a green tick.

This reverts commit 4d1a78e9707fe52676074e600289e770a17720d8.

wrap page/article content in blocks
for easier extension/customization/overriding of templates

documentation/python: parametrize tests with search data version.

doc: fix a path.

documentation: improve search short data test to depend on header size.

So when we move to bigger types, it still catches outdated assumptions.

documentation: calculate the result index differently.

documentation: reduce magic constants in search implementation a bit.

documentation/python: ignore more stuff added by typing.

documentation/python: ignore __next_in_mro__ under Py3.6.

documentation/python: repro case for another Py3.6-specific typing thing.

documentation/python: improve the Py3.6-specific _gorg workaround.

This should fix the assert reproduced by the previous commit, though the
__next_in_mro__ still needs to be ignored.

documentation/python: avoid aliasing the type() builtin.

documentation/python: a futile attempt to improve a firing assert.

Continuation of f45a8b060c5cd875da1fe66982025627c2747359.

documentation/python: attempt to reproduce a Py3.6-specific typing issue.

documentation/doxygen: if the thing crashes, I'd like to be informed.

Otherwise people blame me, and not Doxygen.

templates: use an empty alt for navbar brand image.

Helps screen readers (and textual browsers) ignore the image as
non-essential. Another variant would be putting some text there, but
since the brand name is right after, it would be superfluous, not
giving any additional information.

m.htmlsanity: apply .m-link-wrap to plain URL links.

css: add .m-link-wrap class for wrapping long link URLs.

And add actual docs mentioning various wrapping methods.

Update CREDITS.md.

documentation/doxygen: do not show Doxygen version 0 on empty index.

Co-authored-by: Vladimír Vondruš <mosra@centrum.cz>

documentation/python: more graceful handling of duplicate classes.

Not ideal (as the resulting docs are confusing), but at least something.
Creating two copies of the same class could easily lead to infinite
recursion in code paths that don't expect it, so not doing that.

documentation/python: deterministic formatting of function values.

Otherwise it would be a different hash every time.

documentation/python: dedicated test for value formatting.

documentation/doxygen: create the output dir because Doxygen is stupid.

It can't create nested directories.

Adapt to matplotlib output changes as well.

Yet another variant of a graphviz dot output.

documentation/doxygen: avoid useless detailed docs in some cases.

If a class was spread over more files (either because of related
functions or because Doxygen bugs) and SHOW_INCLUDE_FILES was disabled
or the file was not documented, the detailed docs contained nothing
except brief, being useless. Do not add them in that case.

documentation/doxygen: don't warn about _EXPORT / _LOCAL.

Magnum-specific, was added at a time when this wasn't used anywhere
else. It doesn't make sense to have this here, as every project would
need a different set of checks. Could be doable externally via various
hooks, removing this for now.

documentation/doxygen: support colspan/rowspan in tables.

New in 1.8.18.

package/ci: use doxygen 1.8.17.

1.8.16 and older got deleted from there, so there's no other option
anyway. OTOH 1.8.18 doesn't work on Ubuntu 16.04 anymore (FFS) so I have
to stay on 1.8.17.

documentation/doxygen: can't keep up with the bugs.

Now there's a superfluous static in the function return type. (Yes, the
hash difference is due to this. Yes, I smelled the regression
correctly.)

documentation/doxygen: it calculates a hash of this func differently now.

Um. I smell a hidden bug or A REGRESSION INCOMING.

documentation/doxygen: 1.8.18 parses Markdown differently, it seems.

Better, even. Unheard of.

documentation/doxygen: thanks for this bug also.

documentation/doxygen: thanks for new bugs, 1.8.17.

documentation/doxygen: it no longer produces an empty graph here.

Okay, I guess.

documentation/doxygen: drop handling for a Doxygen 1.8.15 bug.

doc update the Pygments CSS generation snippet for Py 3.8.

css: fix a typo in the CSS file.

Sorry if this broke your things.

css: update console theme to match updated KDE's Breeze.

It has a slightly better contrast and not so oversaturated colors, being
easier on the eyes. The previous one was also based off KDE, but they
updated it since.

m.code: improve ANSI coloring to work on ASan output as well.

documentation/python: fix a cyclic crawl corner case in Python 3.6.

documentation/python: attempt to reproduce a Py3.6-specific issue.

fix typo "pygments-dark" -> "pygments-console"

fix encoding

Updated CREDITS.rst.

fix compile on windows (with code page 1251)

documentation/doxygen: support \since as labels in entry lists.

Makes everything much easier to discover. Since I'm by far no longer the
only user, I have a fear of breaking things, so this is completely
opt-in.

Also recognizes a combination of \since and \deprecated as "a version in
which given API got deprecated", expanding the red deprecated label with
a custom text.

documentation/doxygen: support adding classes to \ref.