On 7/12/21 8:43 PM, Friedrich W. H. Kossebau wrote:
Am Montag, 12. Juli 2021, 20:22:30 CEST schrieb Frederik Schwarzer:
On 7/12/21 7:38 PM, Friedrich W. H. Kossebau wrote:
Now what is meant by "clickable links to replacements" exactly? Any
example
for what you have in mind?
(Just in case, Doxygen usually itself already generated automatic links to
the functions (just needs complete signature, incl. const), see also
https://www.doxygen.nl/manual/autolink.html
but then I would guess you know that)
Yes, that's what I meant. api.k.o does have clickable links (if done
properly) but compiler warnings do not. That's why it would be good to
keep the KF5 api docs.
Ah, so html pages on a server/local docs in QCH vs. compiler log, I see :)
If we put URLs in the messages, we could click them in Konsole. ;)
Any insight on how you kept the KDE 2-4 apidocs alive?
Mainly defending against admin wanting to clean up dead stuff and just wiping
the current freak setup behind api.kde.org ;) (which is https://
invent.kde.org/websites/quality-kde-org)
Right now the kdelibs 2-4 docs are no longer regenerated (at the time when I
got involved only the 4 one still was, but now also no longer is, and just is
static files on the web server. I did some URL updates e.g. for trolltech.com-
qt.io using mass regexp replacements on them).
IIRC main file of the generation is
https://invent.kde.org/websites/quality-kde-org/-/blob/master/apidox/src/
gendox.sh
But I dropped out when there were people talking about their progress in
writing a replacement and put my hopes & bet on them. But seems life got in
then it seems...
I cannot check what is used on the server but I was told
https://invent.kde.org/frameworks/kapidox/-/blob/master/src/kapidox_generate
would be the script that generates apidocs on the server.
Maybe someone can clarify?
CHeers,
Frederik
