Adding further modules to api.kde.org

Martin Graesslin mgraesslin at kde.org
Mon Sep 28 08:04:28 UTC 2015


On Saturday, September 19, 2015 1:11:24 PM CEST Allen Winter wrote:
> On Saturday, September 19, 2015 07:03:40 PM Martin Graesslin wrote:
> > On Saturday, September 19, 2015 12:54:57 PM CEST you wrote:
> > > http://api.kde.org/4.x-api/workspace-apidocs/kwayland/html/index.html
> > > look ok?
> > 
> > hmm that doesn't use the wonderful README.md. Compare to
> > http://kde.martin-graesslin.com/kwayland/index.html (requires IPV6)
> > 
> > Interestingly whenever I locally generated with kgenapidox it included the
> > README.md and I did verify after adding the .dox file that it doesn't
> > change. What's used on ebn to generate the docs?
> 
> Ancient scripts that predate kgenapidox by at least a decade.

ahah :-D

> I wonder if symlinking Mainpage.dox to README.md would work for now.
> I'll try that

I'll add some minimum information to Mainpage.dox in case it doesn't work. I 
don't want to do a complete copy into doxygen format as I fear them to get out 
of sync.

> 
> > > what would be a better url for this?
> > > perhaps http://api.kde.org/plasma-apidocs/kwayland/html/index.html ??
> > 
> > My opinion would be workspace is better as that's what our module is still
> > called on projects.kde.org. If others think it should be plasma I won't
> > oppose ;-)
> 
> http://api.kde.org/workspace-apidocs/kwayland/html/index.html ??

sounds good!

Cheers
martin

> 
> > Anyway: thanks for putting it up. Much appreciated!
> > 
> > Cheers
> > Martin
> > 
> > > On Friday, September 11, 2015 08:10:37 AM Martin Gräßlin wrote:
> > > > Am 2015-09-10 21:50, schrieb Allen Winter:
> > > > > On Thursday, September 10, 2015 10:57:10 AM Martin Graesslin wrote:
> > > > >> Hi all,
> > > > >> 
> > > > >> back in KDE4 days the workspace libraries were listed on
> > > > >> api.kde.org
> > > > >> [1]. But
> > > > >> for the current version we don't have any API docs available. The
> > > > >> section
> > > > >> "Other KDE Software" [2] lists KDE Support, KDE Extragear and
> > > > >> Playground but
> > > > >> apparently nothing from what used to be KDE SC.
> > > > >> 
> > > > >> Does anybody know how I can get our KDE Workspaces listed there
> > > > >> again?
> > > > >> I'm in
> > > > >> particular interested in getting KWayland API documentation
> > > > >> published.
> > > > >> 
> > > > >> If nobody knows: does anyone know who needs to be poked.
> > > > > 
> > > > > http://api.kde.org/4.x-api/workspace-apidocs/ exists
> > > > > The KDE SC stuff is shown under "KDE4 Versions"
> > > > > http://api.kde.org/history4.php
> > > > > 
> > > > > I do notice that under the various KDE 4.foo tables we don't have a
> > > > > workspace entry
> > > > > we have kde-workspace, but not workspace.  seems like kde-workspace
> > > > > and workspace are similar.
> > > > > 
> > > > > I'm not sure there's anything to fix.
> > > > 
> > > > Well it's KDE4, it's old and outdated. It doesn't list new modules
> > > > like
> > > > the new KDecoration library or KWayland.
> > > > 
> > > > Looking at the documentation it seems like at least KWin's
> > > > documentation
> > > > is from latest master - this is rather unexpected to be found under
> > > > "KDE4".
> > > > 
> > > > So yes I think there is lots to fix and I'm willing to look into it.
> > > > Just I need to be told how.
> > > > 
> > > > If I as the maintainer are not able to find the documentation of my
> > > > own
> > > > software, nobody else is. Just that should show that there is quite
> > > > something to fix ;-)
> > > > 
> > > > Cheers
> > > > Martin
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 181 bytes
Desc: This is a digitally signed message part.
URL: <http://mail.kde.org/pipermail/plasma-devel/attachments/20150928/7e301f4a/attachment-0001.sig>


More information about the Plasma-devel mailing list