Re: Adding further modules to api.kde.org

[Martin Graesslin]

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.

Re: Adding further modules to api.kde.org

[Alex Merry]

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

[Allen Winter]

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

[Martin Graesslin]

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

[Allen Winter]

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

[Allen Winter]

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

[Martin Graesslin]

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

[Martin Graesslin]

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

[Martin Gräßlin]

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

[Jeremy Whiting]

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

[Adriaan de Groot]

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

[Jeremy Whiting]

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

[Allen Winter]

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

[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.

-Allen

Re: Adding further modules to api.kde.org

[Jeremy Whiting]

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
>
>