documentation/python: adapt builtin method filters to changes in 3.11+.

documentation/python: match the filtered builtin functions to the source.

So when a new Python version changes the docstring, it can be easily
found.

documentation/python: don't use test skipping for version branching.

So much duplication, ew.

documentation/python: enum.IntFlag in newer Python doesn't like NPOT.

The FLAG_SEVENTEEN _is_ there if I explicitly call it, but it doesn't
show up in autocompletion or help. Turning it into a power-of-two value
makes it appear.

Heh. Heh.

documentation/doxygen: properly escape HTML <>s in a test.

This was making Doxygen 1.10 + 1.11 fail parsing the link title,
substituting for an empty text. Funnily enough 1.12 doesn't suffer from
that anymore, which is what made me think that was a Doxygen bug and not
mine. Well it still *is* a Doxygen bug, but at least now I can have
consistent output everywhere.

documentation/doxygen: adapt test to spacing changes in math in 1.9.x.

Not sure which version, really. Don't want to plow through the
messy changelogs.

documentation/doxygen: undo the crap Doxygen does to inline namespaces.

Like, COME ON, WAS THAT "CONVENIENCE FEATURE" REALLY WORTH THE EXTREME
ADDED PAIN FOR EVERYBODY ELSE??? Fuck me.

documentation/doxygen: this bug with includes happens only on < 1.8.20.

documentation/doxygen: use a correct condition in the test.

It's broken like that in 1.9.7 already. That's what I get for pushing
09ddeebf4e77b8912bd8c914c5f75b25dd79d8a1 to master at 4 AM.

documentation/doxygen: Doxygen 1.11 can already produce <sect6>.

What an amazing piece of thing.

documentation/doxygen: work around Doxyen stupidly making XMLs useless.

I still hope that particular change can be reverted, but so far it's
just the least possible amount of work to make this tool not hit a
sanity assert.

documentation/doxygen: avoid hitting the typedef dedup bug in tests.

https://github.com/doxygen/doxygen/pull/11141

Sigh. I'd really like to have at least one Doxygen version newer than
1.8.18 on the CI, but it's a minefield because my tests work as designed
and hit each and every regression and silly bug.

documentation/doxygen: adapt this test file to whitespace normalization.

The latex output is extremely random so I ignore those tests locally,
yet this particular bit is what 50a7fc5324198f45cde042c87c7a0b4f651b3d25
should have contained also.

documentation/doxygen: two more ElementTree deprecation warnings.

Missed those in 2588ef1a9a5420fa6b0dc39769ce582ce5dc5bd3.

m.plots: replace hashes in test files before comparing.

Similarly to what I did for doxygen, the damn thing now has hashes
differing even between machines. How the hell is one supposed to make
reproducible builds with that, I don't know.

The 3.4 variant got removed, because it differs from 3.2 only in those
hashes, so it isn't needed anymore. Now I can finally unpin it from 3.7
on the CI and stop being afraid that it changes again with 3.9.3.

documentation/doxygen: use a type with known stable hash in a test.

Because every const, < or > matters with this thing. Every new release
is different hashes, FFS. This handcrafted name fortunately has the same
URL hash in both 1.8.16 and 1.12.

documentation/doxygen: superfluous } in a test.

KDevelop complains, Doxygen didn't even notice this was a bug I guess.

documentation/doxygen: omit filename in anchors to the page itself.

I'm already doing that for all links coming from the template
(crosslinks between member lists and detailed info, section heading
links etc.) but so far it wasn't done for links and references contained
in Doxygen comments themselves.

That not only makes the generated files smaller, especially when there's
a lot of cross-references with large namespace docs full of functions
and typedefs, but also makes the output consistent between 1.8.16 and
1.12, which is why I'm doing this in the first place.

documentation/doxygen: avoid another version-specific parsing behavior.

While the empty paragraph made 1.8.16 turn the second item into a
paragraph as well, 1.12 now treats that as the end of the list. Use
another sentence instead, which behaves the same on both.

documentation/doxygen: don't rely on a Markdown parsing bug in a test.

This was deemed to be an error in
https://github.com/doxygen/doxygen/commit/5f75ff14582400a77068df5ff0f4f0ec0693adee
and 1.9.3+ doesn't behave like that anymore.

documentation/doxygen: anonymous namespaces no longer garbage in 1.9.7+.

They no longer have <compoundname> containing some randomly generated
string containing @, but it's empty instead. Similar as with enums that
were adapted to in c0194a3eb81057a3b029e66cf389a35f64375eef.

documentation/doxygen: some Markdown autobrief insanities gone in 1.12.

documentation/doxygen: noexcept and constexpr no longer leaks into types.

Since Doxygen 1.11. Which means I now have to use the attributes. No
change to the test files is needed, without this change 1.11+ would
produce output that doesn't have noexcept and constexpr.

documentation/doxygen: Doxygen 1.12 can produce up to <sect6>.

And is slightly less broken when encountering Markdown headers where
it's not #'s at the start of the line but underneath.

documentation/doxygen: normalize hashes before comparing files.

Each Doxygen version differs slightly in those and I just have no
patience for it. The actual on-disk files keep the originals so anchors
and everything works, but they're replaced when comparing.

documentation/doxygen: properly adapt all tests to graphviz 10.

Forgot this in 182939f4d403c42c061b6d37907fab2286b6da24.

documentation/doxygen: remove static keyword from variable types as well.

Like was done in a74bdefc58a34b8054e61e84b480ad6cf0105ad2 for functions.
I didn't notice until now, but Doxygen 1.11 finally fixed that, which
uncovered the mistake in the test_compound.Listing test.

documentation/doxygen: normalize spacing around inline <mcss:*> tags.

Those are \xmlonly, and Doxygen 1.12 (or anything between 1.12 and
1.8.16) seems to put one more space there, causing useless differences
in test files. Replacing those with just one space to have a consistent
output across all versions.

test: fix Python 3.12 warnings about invalid escape sequences.

Or maybe 3.11 warned too and I just didn't notice?

documentation/python: adapt to changes in Python 3.12 builtins docs.

documentation/doxygen: whoops, bad test filename.

Broken since 182939f4d403c42c061b6d37907fab2286b6da24.

documentation/doxygen: fix hopefully all ElementTree deprecation warnings.

No, it didn't get any better with this change. Only more brittle.

documentation/doxygen: fix anonymous enum parsing with 1.9.7+.

documentation/doxygen: expand the enum test with anonymous enums.

This was verified only in an "integration" test along with a ton of other
features, better to have a dedicated case for it as well.

docummentation/python: adapt __weakref__ ignore to Python 3.11.

package/ci: pin to numpy and pybind11 that work together.

Without breaking my tests. Gah, I hate this pointless churn.

doc: adapt Build Status to codecov API changes.

doc: updated credits.

m.htmlsanity: traverse() is deprecated since docutils 0.18.

Looks like it got changed to an iterator to be faster, unfortunately
Sphinx relied on it returning a list, so it got changed back and
deprecated in favor of findall().

Using the new name and adding it as an alias for traverse() on older
versions.

m.code: reprunicode() is also gone in docutils 0.21.

Their changelog says it was there just for compatibility with Python 2,
which m.css never supported anyway.

Co-authored-by: John Turner <7strbass@gmail.com>

m.code: stop using stuff removed in docutils 0.21.

The uses were just copypaste from the upstream implementation, and out
of all imports only the error string was used. The documentation
suggests using just str() instead, which is what I do, even though it's
different from what ErrorString actually formatted.

m.dot: adapt test to differences in output with graphviz 10.

Or 9, or maybe 8 or 7. The version I tested with before was 2.44, no
idea why was it so important to suddenly change the versioning scheme
like this.

m.plots: adapt tests to different output with matplotlib 3.6+.

Unfortunately version 3.8+ has different output YET AGAIN, meaning I
have to pin again until I build up the patience to retry all this.

m.qr: adapt to different output in qrcode 7.4.

Stop using deprecated distutils.version.LooseVersion in tests.

I was waiting *half a decade* for this to get resolved in a less than
insane way, but NOPE. Instead of using builtin functionality for such a
basic operation as version comparison (heck, even CMake has that
builtin!!) we're now instructed to PIP INSTALL PACKAGING. Where did the
"batteries included" spirit go? Why is everything increasingly
overengineered? Why can't a project stay in place for a few years, WHY
DO I HAVE TO ADAPT TO MEANINGLESS CHANGES ALL THE TIME?!

latex2svg: restrict the libgs workaround to dvisvgm < 3.0.

On newer versions this isn't needed, and the hardcoded paths aren't
always enough. So better to just not try at all.

css: support .m-image and .m-figure for <video> as well.

latex2svg: look for libgs.so.10 in /usr/lib64 as well.

Update copyright year.

Six months in, I could have waited until 2024, heh.

Stop mentioning Pelican -- it's a general site theme independent of it.

doc: properly show that a class directive *is* needed for a table.

The output markup had it but the snippet not, causing confusion.

m.code: make it work with newer docutils.

Not sure when this got broken but omitting the option no longer works.

documentation/python: test external doc overload matching with * and /.

With the previous commit this now "just works", as the placeholders are
dropped from the final signature. The test thus works mainly for
documenting this feature.

documentation/python: recognize / and * in pybind11 signatures.

documentation/python: ignore a new useless builtin on 3.11.

documentation/python: don't use deprecated distutils.

Turns out the version info can be compared much more easily. Thanks
Python, this is nice.

latex2svg: work around dvisvgm < 3.0 not detecting ghostscript 10.

The latex stack and everything around it is ... interesting. A huge pile
of stuff that randomly breaks in very silent and non-obvious ways, and
it's all so huge and complicated that even distro package maintainers
have no way to know if the packages are mutually compatible.

Now that I figured this out, I still need to comment on that ArchLinux
bug.

latex2svg: more robust handling of libgs not being found.

Instead of just looking it up upfront and then hoping for the best,
verify also that dvisvgm actually detected and used it. Because it not
always does, in particular with versions < 3.0 and ghostscript 10.

m.code: minor.

css: reduce size of the jumbo header.

The previous size was unbearable with longer titles such as in
https://blog.magnum.graphics/backstage/cpu-feature-detection-dispatch/

doc: update command line for Pygments CSS generation.

m.code: support inverse video in the ANSI lexer.

I'm very glad for the extremely extensive code coverage here. Without
it, I'd break half of other stuff by accident.

m.code,doxygen: test inline ANSI code highlighting.

Because it got broken with Pygments newer than the ancient 2.6.1 fork I
have (it now unconditionally adds a wrapper <div>), and unfortunately I
can't see how to not do that in 2.14 without delegating into private
APIs.

So just to have that problematic part reproduced in tests, once I get to
that. Unfortunately latest Pelican doesn't work with older Pygments
anymore for some reason (or, well, disallows it), so I can't generate
the website until I have this fixed properly. Ugh.

package/ci: the eternal trash fire of random packages breaking!!

I have no patience for any of this.

documentation/python: test using :property: in a class docstring.

It works, I just wasn't sure if there wasn't something special regarding
docstrings so I had to check explicitly.

documentation/doxygen: support styling <dl> with CSS classes.

So I can make my own footnotes. Finally I got to know what kind of
markup is abused for the autogenerated TODO lists.

css: document that a <table> can be .m-fullwidth.

I kinda forgot all the particulars since I made this five years ago, so
better document everything for my old soul.

package/ci: I HATE WEB DEVELOPMENT

All packages getting changed all the time with stupid differences. IT IS
NOT POSSIBLE TO JUST HAVE A PROJECT WORKING FOR SIX MONTHS WITHOUT A
CONSTANT NEED FOR ADAPTING TO CHANGES IN DEPENDECIES FFS!!!

I miss developing against Qt, where the APIs I used in 2007 were still
there in 2014. ARGH

Updated CREDITS.md.

fix typos in m-components.css

m.code: fix ANSI lexer compatibility with Pygments 2.12+.

I'm still pinned on an older version because of the significant
difference in output, but it shoulnd't crash at least.

m.dox: document a rather nasty abuse of lack of python variable scoping.

m.dox: restore compatibility with cppreference tag files.

These put the filename into a different tag, and don't use anchors.

m.dox: test & fix linking to files, defines and macros.

The tagfile has an absolute path for some reason, but not going to
bother with that right now. The code was also appending one extra .html
extension, which is fixed.

m.dox: allow linking to variables as well.

I have *many* tags now, and need to be able to refer to them.

m.dox: properly test also links to typedefs, enums and enum values.

Instea of updating the Corrade tagfile, which would be several megabytes
of useless data, I'm now cherry-picking just what's changed.

Will make updates slightly harder but not impossible (can't just replace
the whole file but have to cherry-pick again). OTOH I can now use the
same approach for STL-tagfile-specific workarounds instead of bundling
another 2 MB of XML data.

Use two-space indentation for Doxygen tagfiles.

Updated CREDITS.rst.

documentation/doxygen: explanatory comments for parts without CI coverage.

Also restoring the note about the cpp_function_attributes regression
test.

doxygen: fix keywords leaking into return type

- fixes #225
- fixes #226

Also drive-by added support for C++20's `consteval` keyword.

Fix documentation typos

Updated CREDITS.rst.

documentation: Use https links instead of git links.

GitHub no longer supports git:// links. Trying to
following the clone instructions leads to an error:
>  The unauthenticated git protocol on port 9418 is no longer supported.
> Please see https://github.blog/2021-09-01-improving-git-protocol-security-github/ for more information.

documentation/doxygen: don't omit functions w/o brief from file docs.

Before, functions that contained for example /** \overload */ were
omitted from file docs, leading to user confusion.

And document the behavior more thoroughly -- took me a while to realize
this condition was really responsible for this.

documentation: it's Doxyfile.xml I shall ignore, not Doxyfile.html.

Made an error in 45911a18 and apparently it was fine because it silently
returned in some later check.

Jabber? What's that?

Updated CREDITS.rst.

Fix various typos

Found via `codespell -q 3 -L nd,te`

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

documentation/doxygen: don't trip up on WEIRD macros parsed as functions.

documentation/doxygen: the xrefim order change was just "temporary".

Followup to 4ec09a2c97f60c2c673de337d7dabdc198592f4a. A temporary
regression from 1.8.18 to 1.8.20, 1.9.0 is back to what 1.8.17 had. Heh.
Heh.

documentation/doxygen: silly block-separating workaround for Doxygen 1.9.

Now the new test_contents.Blockquote test passes fully.

documentation/doxygen: drop STUPID &zwj; in <blockquote>.

What the hell, such a pile of unnecessary work. FFS.

documentation/doxygen: fix Doxygen 1.9 code-after-blockquote bugs.

Before it was wrapped in a dedicated paragraph, now it's not anymore.
Thus, if a <programlisting> is right after a <blockquote> and there's
nothing else after it until the end of <para>, it should be treated as a
code block again.

documentation/doxygen: dedicated test for Doxygen 1.9 blockquote bugs.

And removing the problematic interaction from the general typography
test -- it's now here instead.

documentation/doxygen: adapt to different \dotfile handling in 1.9.3.

documentation/doxygen: don't add a space between <p> and <code>.

Seems obvious in retrospect, but for some reason I never realized.

documentation/doxygen: fix another void \return docs warning with 1.9.

Followup to 568edda0b4c2f4ff53652a28aa27a89cb54c2aac.

Updated CREDITS.md.

latex2svgextra: adapt to minor changes in dvisvgm 2.12 preamble.

And add an actually useful assert message.

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

documentation/doxygen: add a clarifying note to the test Doxyfile.