[PATCH wayland 4/4] doc: Add auto-generated Wayland Library chapter

[Tiago Vignatti]

On 10/12/2012 12:57 AM, David Herrmann wrote:
> Hi Tiago
>
> On Thu, Oct 11, 2012 at 4:42 PM, Tiago Vignatti
> <tiago.vignatti at intel.com> wrote:
>> For now only Wayland Client API is described on that chapter, which is
>> extracted via doxygen on ./src/wayland-client.h. We apply a stylesheet
>> (doxygen-to-publican) on doxygen output so it becomes docbook valid.
>>
>> Now all we need to do is populate that header while developing in order to
>> grow a decent documentation. So please use it!
>>
>> Signed-off-by: Tiago Vignatti <tiago.vignatti at intel.com>
>> ---
>>
>> What do you think about this really?
>>
>> My goal would be to mix the static docbook API descriptions (we have only one
>> atm, wl_display_connect.xml) with the auto-generated ones, giving priority for
>> the first always. That would give flexibility for expanding the publican book
>> and the man pages in the way we want but also keeping the completeness of all
>> API documented. I like the idea myself, but I'm really lacking xslt foo for
>> building this now :/
>>
>> Thanks.
>
> As discussed on IRC I really like this approach. It puts all
> documentation into the place where it belongs to. API docs will be
> available as doxygen comments in the wayland-headers and we can
> generate publican docs and man-pages out of it.
> Protocol-documentation will be available in protocol/wayland.xml and
> we already use this to create the publican docs. And all the overview
> pages can be static XML files in ./doc/ that we can use to create
> manpages and publican overview pages.
>
> I will be looking into writing the XSL files to generate the
> man-pages. However, it's a mess installing publican here so I will
> probably not work on the publican XSL files.

great! Seems that now Ander is working on the top of this patchset also 
and adding doxygen style information on libwayland headers. So the tree 
with this work is here:

http://cgit.freedesktop.org/~vignatti/wayland/log/?h=doc

Thanks,

Tiago