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.

Fix typo "make advantage" -> "take advantage"

documentation: Added support for strikethrough markdown formatting

in Doxygen documentation (`~~`).

pelican-theme: I thought the M_HTML_HEADER option was there always.

But apparently not.

documentation: fix a crashy corner case with the typing module.

WHY IS IT SUCH A DUMPSTER FIRE

documentation: save 0.6 kB per page by optimizing the magnifier SVG.

I should have used <use> since the beginning, heh. The magnifier is now
exported with Inkscape with just 3 significant decimal places (instead
of 5) and that's apparently more than enough.

documentation/python, m.sphinx: support documenting raised exceptions.

m.sphinx: improve docs in various places.

documentation/python: clean up and fix property doc extraction.

Now it's no early returns, making the docstring parsing less
duplicated, and also fixing the problem with slots/attrs/getset things
not being exposed to search.

documentation/python: test that a slot is properly added to search.

It's not because extract_property_doc() has a few early returns that
fail to execute the search-adding code.

doc: i wrote this half asleep, apparently.

documentation/python: this should be checking for subtitle, actually.

Otherwise it prints None there and that's everything but desired.

documentation/doxygen: well, whatever.

This is a weird quirk of the Doxyfile parsing. I don't care, actually.
Not worth spending time on. Put quotes around.

Support navbar project / brand logo in all three themes.

css: add styling for brand logo in the navbar.

Interesting, I added support for this into the Pelican theme at the
very beginning, but didn't actually get to styling or testing it at
all.

doc: various minor improvements.

css: support .m-badge on standalone images as well.

css: deduplicate block/inline styling.

css: make it possible to control console color directly.

Having it the same as --code-color makes it impossible to have dark
console listings combined with light code listings. Also while at it,
made .m-inverted line highlighting work with console listings too.

This has a minor visual change for for higlighted .m-inverted lines --
probably by accident those were not reverted back to --code-color, but
rather --color, making them darker than they should be in the dark
theme.

css: make it possible to specify a different color for header breadcrumb.

With brightly-colored headers the usual dim color doesn't make sense.
No visual change to the builtin themes, only adding flexibility for 3rd
party styles.

css: style search background separately from the header navbar.

Otherwise it's too much of a pain with bright-colored headers. No
visual change to the builtin themes, just adding flexibility for 3rd
party ones.

documentation/python: create output dir for each file if not exists.

Otherwise an URL_FORMATTER putting things into subdirs won't really
work.

documentation/python: extend URL_FORMATTER also to static data.

m.sphinx: add an option to repack a decompressed inventory file.

m.sphinx: dirty hack to make this file directly runnable.

Because having to do

    python -m m.sphinx somefile.inv

is too unintuitive to remember.

m.sphinx: ensure fully qualified name links always have a precedence.

The previously added test now passes.

documentation/python: test that fully qualified links get a precedence.

They don't, unfortunately.