mirror of
https://gitlab.freedesktop.org/wayland/wayland.git
synced 2025-10-29 05:40:16 -04:00
dfc64f9ffe
(this is different from previous version as it removes some broken and irrelevant changes to the protocol appendix). This removes all the validation errors except for missing link targets. You can test this by removing the --skip-validation from doc/publican/Makefile.am. Main changes are to avoid nesting <para> commands. I also used <simpara> in some places to reduce the amount of blank space. And the reference id's are prefixed with the chapter name to avoid collisions between libclient and libserver. PS: it would be useful if somebody who actually knows something about xslt would come up with a way to translate a block of text makde of <para> commands unchanged, but add <para> around plain text. Most of the difficulty is that doxygen's output is rather inconsistent here. Tested-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>
51 lines
1.5 KiB
XML
51 lines
1.5 KiB
XML
<?xml version="1.0" ?>
|
|
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
|
|
<xsl:output method="xml" encoding="UTF-8" indent="yes" />
|
|
|
|
<xsl:template match="/">
|
|
<!-- insert docbook's DOCTYPE blurb -->
|
|
<xsl:text disable-output-escaping = "yes"><![CDATA[
|
|
<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
|
<!ENTITY % BOOK_ENTITIES SYSTEM "Wayland.ent">
|
|
%BOOK_ENTITIES;
|
|
]>
|
|
]]></xsl:text>
|
|
|
|
<section id="sect-Protocol-Interfaces">
|
|
<title>Interfaces</title>
|
|
<para>
|
|
The protocol includes several interfaces which are used for
|
|
interacting with the server. Each interface provides requests,
|
|
events, and errors (which are really just special events) as described
|
|
above. Specific compositor implementations may have their own
|
|
interfaces provided as extensions, but there are several which are
|
|
always expected to be present.
|
|
</para>
|
|
|
|
<para>
|
|
Core interfaces:
|
|
<variablelist>
|
|
<xsl:apply-templates select="protocol/interface" />
|
|
</variablelist>
|
|
</para>
|
|
</section>
|
|
</xsl:template>
|
|
|
|
<!-- Interfaces summary -->
|
|
<xsl:template match="interface" >
|
|
<varlistentry>
|
|
<term>
|
|
<link linkend="protocol-spec-interface-{@name}">
|
|
<xsl:value-of select="@name" />
|
|
</link>
|
|
</term>
|
|
<listitem>
|
|
<simpara>
|
|
<xsl:value-of select="description/@summary" />
|
|
</simpara>
|
|
</listitem>
|
|
</varlistentry>
|
|
</xsl:template>
|
|
|
|
</xsl:stylesheet>
|
|
<!-- vim: set expandtab shiftwidth=2: -->
|