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.

documentation/python: format overloaded func ID only if it's overloaded.

So "pybound" functions without overloads still can have nice IDs and
URLs. This should have been done together with
1cd0bb44b77b4225fc5156e1ea7c1a790fe9f7a8 and
6db6b4c4f8296b0fa1b08ce6edeb942db321f6b4 already, but somehow I didn't
make the connection.

documentation/python: avoid aliasing variables in signature parsing code.

And avoid unpacking the whole tuple when we need just one item. It was
very hard to reason about otherwise.

m.sphinx: allow to link to special pages.

documentation/python: add some TODOs.

plugins: leave this there commented-out so I don't need to search again.

m.sphinx: implement a page-wide :ref-prefix: option.

NOW I can start writing real docs without everything being a giant PITA.

documentation/python: fire scope hooks for page rendering as well.

Right now this will be used to implement a page-specific :ref-prefix:
option, but in the future it can be used also for relative linking to
pages and such.

doc: uh oh.

Various bits to improve code coverage.

documentation/python: pull additional stuff from __annotations__.

documentation/python: include documented underscored names.

documentation/python: don't die on reST errors in pages.

documentation/python: this copypaste is like a cancer.

Spreads everywhere.

documentation/python: avoid blowing up on __name__ not being an attrib.

Don't want to test for this, seems too obscure.

documentation/python: handle ... in type annotations.

Until now I didn't know code like `if annotation is ...` is possible.
What will come next, using // as an operator?!

documentation/python: gracefully handle nested annotation parsing failures.

documentation/python: don't be so enthusiastic with pybind sig matching.

documentation/python: test for false positives for pybind signatures.

This blows up. Heh.

documentation/python: try not to use `type` for a variable name.

I wanted to check a type of a variable there.

documentation/doxygen: don't use entity if it fails to be found.

m.code: doc++

Be consistent with the actual output.

m.code: ability to apply filters before/after the code is highlighted.

plugins: don't implicitly depend on Pelican.

Only when those actually get used from Pelican.

documentation/python: use an ellipsis for overly large values.

doc: the Python doc generator is not experimental anymore.

m.sphinx: ignore duplicate entries in intersphinx inventories.

The "index" is the main offender.

documentation/python: ensure relative includes work in parsed docs.

This is quite bad, but ... at least something.

documentation/python: add a NAME_MAPPING config option.

documentation/python: minor naming cleanup.

documentation/python, m.sphinx: support for external enum value docs.

m.sphinx: more convenient module/class data and properties documentation.

Sometimes all you need is just a summary. Discovered during a port of a
larger project, writing all those fully-qualified .. py:property:: for all
members got boring *really* fast.

m.sphinx: extended the section about by-design restrictions.

documentation/python: less responsibility on docstring-processing plugins.

Until now, the plugin was expected to fill both summary and content for
the symbol it's ccalled on. THat made plugin implementation harder than it
should be, causing a lot of code duplication and explosion of testing
effort.

Now the script simply sills in summary / content if it isn't there after
all processing and that's it. No asserts anymore.

documentation/python: consistently use a single way to render Jinja pages.

Otherwise I forget to specify important variables or do other critical
mistakes.

documentation/python: the feeling when you invert an important condition.

This was supposed to check that I was always specifying the version. Well,
it failed to check, and I failed to specify the version properly in all
cases.

documentation/python: implement a bunch of tricks for attrs.

Workarounds! Hacks! Smelly code!

documentation/python: properly shrink first column also with skipped self.

This will break if the docs skip undocumented parameters, but since that's
technically an error, I don't care.

documentation/python: don't forget to handle scope for slots as well.

m.sphinx: added a :p: role for parameter referencing.

So tiny yet so useful. Doxygen, take a note.

documentation/python: implement scope enter/exit hooks.

With this we can have relative links for *everything*.

documentation/python: minor cleanup, naming consistency.