Re: [RFC wayland] doc: generate doxygen html output from the scanner

2015-11-10 Thread Bill Spitzak
On Mon, Nov 9, 2015 at 8:12 PM, Peter Hutterer wrote: > > The GENERATE_TAGFILE option generates a list of all items in xml format > like > this: > > struct wl_event_queue * > wl_display_create_queue > wayland-client-core_8h.html >

Re: [RFC wayland] doc: generate doxygen html output from the scanner

2015-11-10 Thread Peter Hutterer
On 10/11/2015 18:06 , Pekka Paalanen wrote: On Tue, 10 Nov 2015 14:12:48 +1000 Peter Hutterer wrote: On Mon, Nov 09, 2015 at 09:32:52AM +0200, Pekka Paalanen wrote: On Sat, 7 Nov 2015 09:53:10 +1000 Peter Hutterer wrote: On 7/11/2015

Re: [RFC wayland] doc: generate doxygen html output from the scanner

2015-11-10 Thread Pekka Paalanen
On Tue, 10 Nov 2015 14:12:48 +1000 Peter Hutterer wrote: > On Mon, Nov 09, 2015 at 09:32:52AM +0200, Pekka Paalanen wrote: > > On Sat, 7 Nov 2015 09:53:10 +1000 > > Peter Hutterer wrote: > > > > > On 7/11/2015 01:27 , Pekka Paalanen wrote: >

Re: [RFC wayland] doc: generate doxygen html output from the scanner

2015-11-08 Thread Pekka Paalanen
On Sat, 7 Nov 2015 09:53:10 +1000 Peter Hutterer wrote: > On 7/11/2015 01:27 , Pekka Paalanen wrote: > > On Thu, 29 Oct 2015 11:48:01 +1000 > > Peter Hutterer wrote: > > > >> This switches the scanner to generate doxygen-compatible tags for

Re: [RFC wayland] doc: generate doxygen html output from the scanner

2015-11-06 Thread Peter Hutterer
On 7/11/2015 01:27 , Pekka Paalanen wrote: On Thu, 29 Oct 2015 11:48:01 +1000 Peter Hutterer wrote: This switches the scanner to generate doxygen-compatible tags for the generated protocol headers, and hooks up the doxygen build to generate server and client-side API

Re: [RFC wayland] doc: generate doxygen html output from the scanner

2015-11-06 Thread Pekka Paalanen
On Thu, 29 Oct 2015 11:48:01 +1000 Peter Hutterer wrote: > This switches the scanner to generate doxygen-compatible tags for the > generated protocol headers, and hooks up the doxygen build to generate server > and client-side API documentation. > > For the wayland

Re: [RFC wayland] doc: generate doxygen html output from the scanner

2015-11-05 Thread Tiago Vignatti
On 11/04/2015 09:44 PM, Peter Hutterer wrote: On Wed, Nov 04, 2015 at 03:30:29PM -0800, Bryce Harrington wrote: On Mon, Nov 02, 2015 at 10:27:54AM +1000, Peter Hutterer wrote: On Fri, Oct 30, 2015 at 03:40:33PM -0700, Bryce Harrington wrote: but: the current API docs in publican are useless.

Re: [RFC wayland] doc: generate doxygen html output from the scanner

2015-11-04 Thread Peter Hutterer
CC-ing Tiago for the doxygen question On Wed, Nov 04, 2015 at 03:30:29PM -0800, Bryce Harrington wrote: > On Mon, Nov 02, 2015 at 10:27:54AM +1000, Peter Hutterer wrote: > > On Fri, Oct 30, 2015 at 03:40:33PM -0700, Bryce Harrington wrote: > > > On Thu, Oct 29, 2015 at 11:48:01AM +1000, Peter

Re: [RFC wayland] doc: generate doxygen html output from the scanner

2015-11-04 Thread Bryce Harrington
On Mon, Nov 02, 2015 at 10:27:54AM +1000, Peter Hutterer wrote: > On Fri, Oct 30, 2015 at 03:40:33PM -0700, Bryce Harrington wrote: > > On Thu, Oct 29, 2015 at 11:48:01AM +1000, Peter Hutterer wrote: > > > This switches the scanner to generate doxygen-compatible tags for the > > > generated

Re: [RFC wayland] doc: generate doxygen html output from the scanner

2015-11-04 Thread Jonas Ådahl
On Thu, Oct 29, 2015 at 11:48:01AM +1000, Peter Hutterer wrote: > This switches the scanner to generate doxygen-compatible tags for the > generated protocol headers, and hooks up the doxygen build to generate server > and client-side API documentation. > > For the wayland protocol, this generates

Re: [RFC wayland] doc: generate doxygen html output from the scanner

2015-11-03 Thread Peter Hutterer
On Tue, Nov 03, 2015 at 12:37:39PM -0800, Bill Spitzak wrote: > On Sun, Nov 1, 2015 at 6:21 PM, Peter Hutterer > wrote: > > > On Sun, Nov 01, 2015 at 05:41:04PM -0800, Bill Spitzak wrote: > > > On 11/01/2015 04:27 PM, Peter Hutterer wrote: > > > > > > >but: the current

Re: [RFC wayland] doc: generate doxygen html output from the scanner

2015-11-03 Thread Bill Spitzak
On Sun, Nov 1, 2015 at 6:21 PM, Peter Hutterer wrote: > On Sun, Nov 01, 2015 at 05:41:04PM -0800, Bill Spitzak wrote: > > On 11/01/2015 04:27 PM, Peter Hutterer wrote: > > > > >but: the current API docs in publican are useless. look at appendix B, > the > > >"client

Re: [RFC wayland] doc: generate doxygen html output from the scanner

2015-11-03 Thread Bill Spitzak
On Tue, Nov 3, 2015 at 2:02 PM, Peter Hutterer wrote: > On Tue, Nov 03, 2015 at 12:37:39PM -0800, Bill Spitzak wrote: > > On Sun, Nov 1, 2015 at 6:21 PM, Peter Hutterer > > > wrote: > > > > > On Sun, Nov 01, 2015 at 05:41:04PM -0800, Bill

Re: [RFC wayland] doc: generate doxygen html output from the scanner

2015-11-01 Thread Peter Hutterer
On Sun, Nov 01, 2015 at 05:41:04PM -0800, Bill Spitzak wrote: > On 11/01/2015 04:27 PM, Peter Hutterer wrote: > > >but: the current API docs in publican are useless. look at appendix B, the > >"client API". http://wayland.freedesktop.org/docs/html/apb.html > >it's technically the client API but

Re: [RFC wayland] doc: generate doxygen html output from the scanner

2015-11-01 Thread Bill Spitzak
On 11/01/2015 04:27 PM, Peter Hutterer wrote: but: the current API docs in publican are useless. look at appendix B, the "client API". http://wayland.freedesktop.org/docs/html/apb.html it's technically the client API but it's lacking anything that's not core libwayland API. it doesn't describe

Re: [RFC wayland] doc: generate doxygen html output from the scanner

2015-11-01 Thread Peter Hutterer
On Thu, Oct 29, 2015 at 11:00:51AM -0700, Bill Spitzak wrote: > Protocol documentation is produced directly from the xml currently. If it > is merged with doxygen-produced comments then there will be duplication and > possible confusion, so these header files must somehow be skipped when > running

Re: [RFC wayland] doc: generate doxygen html output from the scanner

2015-11-01 Thread Peter Hutterer
On Fri, Oct 30, 2015 at 03:40:33PM -0700, Bryce Harrington wrote: > On Thu, Oct 29, 2015 at 11:48:01AM +1000, Peter Hutterer wrote: > > This switches the scanner to generate doxygen-compatible tags for the > > generated protocol headers, and hooks up the doxygen build to generate > > server > >

Re: [RFC wayland] doc: generate doxygen html output from the scanner

2015-10-30 Thread Bryce Harrington
On Thu, Oct 29, 2015 at 11:48:01AM +1000, Peter Hutterer wrote: > This switches the scanner to generate doxygen-compatible tags for the > generated protocol headers, and hooks up the doxygen build to generate server > and client-side API documentation. > > For the wayland protocol, this generates

Re: [RFC wayland] doc: generate doxygen html output from the scanner

2015-10-29 Thread Bill Spitzak
Protocol documentation is produced directly from the xml currently. If it is merged with doxygen-produced comments then there will be duplication and possible confusion, so these header files must somehow be skipped when running doxygen. That said, it may make sense to just use this and doxygen

[RFC wayland] doc: generate doxygen html output from the scanner

2015-10-28 Thread Peter Hutterer
This switches the scanner to generate doxygen-compatible tags for the generated protocol headers, and hooks up the doxygen build to generate server and client-side API documentation. For the wayland protocol, this generates a mainpage with the copyright information, all interfaces are separated