<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Sun, Nov 1, 2015 at 6:21 PM, Peter Hutterer <span dir="ltr"><<a href="mailto:peter.hutterer@who-t.net" target="_blank">peter.hutterer@who-t.net</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div class=""><div class="h5">On Sun, Nov 01, 2015 at 05:41:04PM -0800, Bill Spitzak wrote:<br>
> On 11/01/2015 04:27 PM, Peter Hutterer wrote:<br>
><br>
> >but: the current API docs in publican are useless. look at appendix B, the<br>
> >"client API". <a href="http://wayland.freedesktop.org/docs/html/apb.html" rel="noreferrer" target="_blank">http://wayland.freedesktop.org/docs/html/apb.html</a><br>
> >it's technically the client API but it's lacking anything that's not core<br>
> >libwayland API. it doesn't describe protocol interfaces at all. That's only<br>
> >in the protocol spec (Appendix A) and that is generated straight from the<br>
> >xml without doxygen's involvement.<br>
><br>
> That page is produced by converting doxygen output into docbook input, so it<br>
> actually matches what you get from doxygen.<br>
<br>
</div></div>But it doesn't scan the actual protocol header, check e.g.<br>
scanned_src_files_Server in the makefile.<br></blockquote><div><br></div><div>It runs doxygen on those source files to produce doxygen xml output (look in doc/doxygen/Makefile.am for scanned_src_files). Then in doc/publican/Makefile.am it uses doc/publican/doxygen-to-publican.xsl to convert that doxygen xml output into docbook input. This mostly preserves the doxygen formatting.<br><br></div></div></div></div>