wayland/doc/Wayland
Peter Hutterer b17e5e1615 doc: improve formatting of client-side documentation
A bunch of changes to the xsl transformation stylesheet to make Chapter 4
(Client API) look nicer and more readable.

Main changes:
- function synopsis listed
- lists for parameters and return values
- long function descriptions
- misc other hooks for "see also", "note", etc

The long description is a sore point. doxygen xml output is difficult to
parse with the output being in the form of
<detailed description>
  <para>
  	<parameterlist> .... </parameterlist>
	<simplesect kind="return">... </simplesect>
	First paragraph of long description
  </para>
  <para>
  	Second paragraph of long <sometag>description</sometag>
  </para>
</detaileddescription>

So we need to ignore parameterlist and simplesect, but extract the text from
everything else. Any improvements on that welcome.

Signed-off-by: Peter Hutterer <peter.hutterer@who-t.net>
2013-04-03 15:44:49 -04:00
..
sources Rename en_US to sources 2013-04-03 15:44:45 -04:00
.gitignore doc: Update .gitignore 2012-11-12 16:08:38 -02:00
doxygen-to-publican.xsl doc: improve formatting of client-side documentation 2013-04-03 15:44:49 -04:00
Makefile.am Rename en_US to sources 2013-04-03 15:44:45 -04:00
protocol-interfaces-to-docbook.xsl doc: Auto-generate Protocol/Interfaces section instead 2012-10-09 22:45:43 -04:00
protocol-to-docbook.xsl doc: don't add a para for an empty summary 2013-04-03 14:44:12 -04:00
publican.cfg doc: publican: Set table of contents depth to 1 2012-10-15 11:44:50 -04:00