diff options
| author | Pekka Paalanen <pq@iki.fi> | 2025-12-27 21:07:06 +0200 |
|---|---|---|
| committer | Pekka Paalanen <pq@iki.fi> | 2025-12-29 11:15:11 +0200 |
| commit | 573c95cb1a5f42c882936c4a6d29fbbfd1d8a50a (patch) | |
| tree | 084befb396227c8395759caf9cc91e63d113d635 | |
| parent | doc: remove HTML_TIMESTAMP (diff) | |
| download | wayland-573c95cb1a5f42c882936c4a6d29fbbfd1d8a50a.tar wayland-573c95cb1a5f42c882936c4a6d29fbbfd1d8a50a.tar.gz wayland-573c95cb1a5f42c882936c4a6d29fbbfd1d8a50a.tar.bz2 wayland-573c95cb1a5f42c882936c4a6d29fbbfd1d8a50a.tar.lz wayland-573c95cb1a5f42c882936c4a6d29fbbfd1d8a50a.tar.xz wayland-573c95cb1a5f42c882936c4a6d29fbbfd1d8a50a.tar.zst wayland-573c95cb1a5f42c882936c4a6d29fbbfd1d8a50a.zip | |
doc/xsl: fix malformed <variablelist>
For all requests and events that do not have any arguments, enabling XML
validation would lead to many errors like this:
/home/pq/git/wayland/build/doc/publican/Wayland.xml:5287: element
variablelist: validity error : Element variablelist content does not
follow the DTD, expecting (blockinfo? , (title , titleabbrev?)? ,
(caution | important | note | tip | warning | literallayout |
programlisting | programlistingco | screen | screenco | screenshot |
synopsis | cmdsynopsis | funcsynopsis | classsynopsis | fieldsynopsis |
constructorsynopsis | destructorsynopsis | methodsynopsis | formalpara |
para | simpara | address | blockquote | graphic | graphicco |
mediaobject | mediaobjectco | informalequation | informalexample |
informalfigure | informaltable | anchor | bridgehead | remark |
highlights | abstract | authorblurb | epigraph | indexterm | beginpage)*
, varlistentry+), got
The reason is that a <variablelist> without any <varlistentry> inside it
is illegal.
If there are no <arg> at all, do not emit the list paragraph.
Signed-off-by: Pekka Paalanen <pq@iki.fi>
| -rw-r--r-- | doc/publican/xsl/protocol-to-docbook.xsl | 12 |
1 files changed, 7 insertions, 5 deletions
diff --git a/doc/publican/xsl/protocol-to-docbook.xsl b/doc/publican/xsl/protocol-to-docbook.xsl index 79c938b..92f8d67 100644 --- a/doc/publican/xsl/protocol-to-docbook.xsl +++ b/doc/publican/xsl/protocol-to-docbook.xsl @@ -186,11 +186,13 @@ - <xsl:value-of select="description/@summary" /> </xsl:if> </title> - <para> - <variablelist> - <xsl:apply-templates select="arg"/> - </variablelist> - </para> + <xsl:if test="arg"> + <para> + <variablelist> + <xsl:apply-templates select="arg"/> + </variablelist> + </para> + </xsl:if> <xsl:call-template name="break"> <xsl:with-param name="text" select="description" /> </xsl:call-template> |