Adding further modules to api.kde.org
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. Cheers Martin [1] http://api.kde.org/4.x-api/kde-workspace-apidocs/ [2] http://api.kde.org/other.php signature.asc Description: This is a digitally signed message part.
Re: Adding further modules to api.kde.org
Martin, I took a look at this as part of the gardening documentation websites, but I didn't get very far. The code that runs this and ebn is in kde:websites/quality-kde-org and is pretty outdated unfortunately. Actually now that Allen Winter is back maybe he could add it (Added him to cc)? What I tried here during gardening which I couldn't get to work locally was: 1. Install it (I had some trouble with the perl based installer putting files in different places than expected, maybe perl itself changed over the years?) 2. Once I manually copied some files to places where they were expected I couldn't figure out how to manually run the doc generator, the --help documentation mentioned what arguments to use, but it wasn't obvious what I should put for my Qt documentation paths and such somehow, so I didn't try anything further. It would be awesome to have what used to be in KDE SC on api.kde.org again. We have many libraries that aren't frameworks that are Qt5/KF5 based which would be good to show on there imo. BR, Jeremy On Thu, Sep 10, 2015 at 2:57 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. > > Cheers > Martin > > [1] http://api.kde.org/4.x-api/kde-workspace-apidocs/ > [2] http://api.kde.org/other.php
Re: Adding further modules to api.kde.org
On Thursday 10 September 2015 06:07:40 Jeremy Whiting wrote: > It would be awesome to have what used to be in KDE SC on api.kde.org > again. We have many libraries that aren't frameworks that are Qt5/KF5 > based which would be good to show on there imo. Perhaps half of this is figuring out what actually constitutes the "Workspace API" that would be interesting here and how to subsequently pull information out of the metadata-services that we have (src-build? projects.kde.org? I don't know, I haven't followed very closely what lives where now). [ade] (who is now reminded that the original ebn domain is expiring and needs renewal, yeah)
Re: Adding further modules to api.kde.org
Well, it's not even just about workspace, we had in kde4 times kdeedu, kdegames, etc. etc. all on api.kde.org. Not all of it was api per se (I don't know anyone that would want to read the apidocs for kanagram for example, except to know how it's internals work or used to work when hacking on it). Currently we only show frameworks and other. This misses a lot of useful documentation, nothing is there about libkomparediff2, libkeduvocdocument, libkdegames, etc. since those aren't generated anymore for some reason. A good idea that Ben suggested when the gardening project started was having the apidocs generate on commit, rather than regenerating everything every night at a specified time. A lot of the sources don't actually change very often, so rebuilding part of the apidocs when the code or it's doxygen comments change would make a lot of sense. BR, Jeremy On Thu, Sep 10, 2015 at 11:05 AM, Adriaan de Groot wrote: > On Thursday 10 September 2015 06:07:40 Jeremy Whiting wrote: >> It would be awesome to have what used to be in KDE SC on api.kde.org >> again. We have many libraries that aren't frameworks that are Qt5/KF5 >> based which would be good to show on there imo. > > Perhaps half of this is figuring out what actually constitutes the "Workspace > API" that would be interesting here and how to subsequently pull information > out of the metadata-services that we have (src-build? projects.kde.org? I > don't know, I haven't followed very closely what lives where now). > > > > [ade] (who is now reminded that the original ebn domain is expiring and needs > renewal, yeah)
Re: Adding further modules to api.kde.org
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. -Allen
Re: Adding further modules to api.kde.org
Allen, Those are both KDE4 versions of workspace stuff. I don't see any place where kf5 versions are. BR, Jeremy On Thu, Sep 10, 2015 at 1:50 PM, Allen Winter wrote: > 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. > > -Allen > >
Re: Adding further modules to api.kde.org
On Thursday, September 10, 2015 01:55:21 PM Jeremy Whiting wrote: > Allen, > > Those are both KDE4 versions of workspace stuff. I don't see any place > where kf5 versions are. > oh. sorry I misunderstood the problem. > > On Thu, Sep 10, 2015 at 1:50 PM, Allen Winter wrote: > > 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. > > > > -Allen > > > >
Re: Adding further modules to api.kde.org
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
Re: Adding further modules to api.kde.org
Hi Allen, is there anything I can do to help get the documentation updated? I want to include KWayland in inqlude (patch is prepared) and I find a little bit embarrassing for KDE to have the api docs to point to http://kde.martin-graesslin.com/kwayland/index.html Cheers Martin On Thursday, September 10, 2015 4:06:31 PM CEST Allen Winter wrote: > On Thursday, September 10, 2015 01:55:21 PM Jeremy Whiting wrote: > > Allen, > > > > Those are both KDE4 versions of workspace stuff. I don't see any place > > where kf5 versions are. > > oh. sorry I misunderstood the problem. > > > On Thu, Sep 10, 2015 at 1:50 PM, Allen Winter wrote: > > > 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. > > > > > > -Allen signature.asc Description: This is a digitally signed message part.
Re: Adding further modules to api.kde.org
Step 1: make sure your projects have a Mainpage.dox at the top-source-level this file can be 0 bytes if you want, but ideally has useful content. see Mainpage.dox in other projects for examples. (Frameworks projects don't need Mainpage.dox, as I recall, but Alex can correct me.) Then at least the apidox will be generated. Step 2: I need to muck with the EBN scripts so the apidox are written to someplace other than the default kde4 location. On Tuesday, September 15, 2015 09:23:08 AM Martin Graesslin wrote: > Hi Allen, > > is there anything I can do to help get the documentation updated? I want to > include KWayland in inqlude (patch is prepared) and I find a little bit > embarrassing for KDE to have the api docs to point to > http://kde.martin-graesslin.com/kwayland/index.html > > Cheers > Martin > > On Thursday, September 10, 2015 4:06:31 PM CEST Allen Winter wrote: > > On Thursday, September 10, 2015 01:55:21 PM Jeremy Whiting wrote: > > > Allen, > > > > > > Those are both KDE4 versions of workspace stuff. I don't see any place > > > where kf5 versions are. > > > > oh. sorry I misunderstood the problem. > > > > > On Thu, Sep 10, 2015 at 1:50 PM, Allen Winter wrote: > > > > 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. > > > > > > > > -Allen
Re: Adding further modules to api.kde.org
On Saturday, September 19, 2015 11:09:51 AM CEST Allen Winter wrote: > Step 1: make sure your projects have a Mainpage.dox at the top-source-level > this file can be 0 bytes if you want, but ideally has useful content. see > Mainpage.dox in other projects for examples. > > (Frameworks projects don't need Mainpage.dox, as I recall, but Alex can > correct me.) awesome, thanks. Just pushed a Mainpage.dox. Didn't expect that was needed as I mostly compared with frameworks. (Suggestion: maybe also check for README.md availability - though with the prospect of phabrictor that's probably a bad idea). Cheers Martin > > Then at least the apidox will be generated. > > Step 2: I need to muck with the EBN scripts so the apidox are written > to someplace other than the default kde4 location. > > On Tuesday, September 15, 2015 09:23:08 AM Martin Graesslin wrote: > > Hi Allen, > > > > is there anything I can do to help get the documentation updated? I want > > to > > include KWayland in inqlude (patch is prepared) and I find a little bit > > embarrassing for KDE to have the api docs to point to > > http://kde.martin-graesslin.com/kwayland/index.html > > > > Cheers > > Martin > > > > On Thursday, September 10, 2015 4:06:31 PM CEST Allen Winter wrote: > > > On Thursday, September 10, 2015 01:55:21 PM Jeremy Whiting wrote: > > > > Allen, > > > > > > > > Those are both KDE4 versions of workspace stuff. I don't see any place > > > > where kf5 versions are. > > > > > > oh. sorry I misunderstood the problem. > > > > > > > On Thu, Sep 10, 2015 at 1:50 PM, Allen Winter wrote: > > > > > 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. > > > > > > > > > > -Allen signature.asc Description: This is a digitally signed message part.
Re: Adding further modules to api.kde.org
http://api.kde.org/4.x-api/workspace-apidocs/kwayland/html/index.html look ok? what would be a better url for this? perhaps http://api.kde.org/plasma-apidocs/kwayland/html/index.html ?? 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
Re: Adding further modules to api.kde.org
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? > > 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 ;-) 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 signature.asc Description: This is a digitally signed message part.
Re: Adding further modules to api.kde.org
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. I wonder if symlinking Mainpage.dox to README.md would work for now. I'll try that > > > > 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 ?? > 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
Re: Adding further modules to api.kde.org
On 2015-09-19 18:11, 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. I wonder if symlinking Mainpage.dox to README.md would work for now. I'll try that Ideally, I'd like it set up so we can move to everyone using the kapidox scripts, but we need some way of switching that on per-repository (like having a Mainpage.dox does with the old scripts). My understanding is that there is code that runs kgenframeworksapidox on the frameworks explicitly, and everything else uses the old scripts. Alex
Re: Adding further modules to api.kde.org
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 signature.asc Description: This is a digitally signed message part.