CMake >= 3.0 supports bracket comments, and the reStructuredText
integration code in sphinx/ext/ecm.py already supports extracting
the docs from a bracket comment instead.
Editing documentation without leading line comment markers is more simple,
e,g. when reflowing text over lines.

With ECM meanwhile requiring CMake 3.5 now it is possible to switch
(and thus follow also the approach used by cmake itself).

NO_CHANGELOG

The code argument has been deprecated in favor of public-code and
private-code options.

In general, it is highly advised to use the private-code option, but we
cannot do it because it will break the ABI.

This is a slightly modernized version of Pino's original implementation
found in KF5 and Plasma.

We have identical copies of this in kinit, kwin, ksysguard and
powerdevil. This makes it a natural candidate for inclusion in ECM.

It is based on the one that can be found in KWin.

Several KDE projects already use libepoxy (KWin and KDeclarative).

Have the C counterpart take care of the C files and the C++ for the C++
files.
Don't forget to skip the server C implementation.

This matters for libraries in the same repository as the application that
also have an AAR that needs to be integrated, as well as QML plugins. For
this to work we need to consider the build directory as a search prefix,
and produce the exact directory layout there that androiddeployqt expects.

For libraries this is then almost transparent for the application build
system, the only thing that needs to be taken care of manually is putting
the corresponding -android-dependencies.xml file into the right place in
the build dir as well. A macro wrapping that might be an option to
centralize that logic here as well in the future.

For QML plugins this is transparent if you have them set up to work without
installation already anyway, otherwise that setup has to be done for this
to work.

Example: https://invent.kde.org/pim/itinerary/-/merge_requests/28

https://invent.kde.org/frameworks/knotifications/-/merge_requests/12 would
presumably also need this (not tested yet).

I had reuse installed but it wasn't being found. Now it is.