From da2e9b5c63e76c9c03e1e45bc3fcacd9f35a0b80 Mon Sep 17 00:00:00 2001
From: Pekka Paalanen <pq@iki.fi>
Date: Sun, 28 Dec 2025 11:25:31 +0200
Subject: doc/xsl: include static inline functions

When generating documentation, xmllint complained:

  element link: validity error : IDREF attribute linkend references an
  unknown ID "Server-structwl__signal_1afe73f44f7f1b517c9c0ba90829c93309"

  element link: validity error : IDREF attribute linkend references an
  unknown ID "Server-structwl__signal_1afe73f44f7f1b517c9c0ba90829c93309"

  element link: validity error : IDREF attribute linkend references an
  unknown ID "Server-structwl__signal_1aa8bcd3b8e250cfe35ed064d5af589096"

These were referring to wl_signal_add() and wl_signal_emit() I think,
which are static inlines in a public header.

The XSLT ignored static functions, probably assuming that they cannot be
public API. Internal (static) functions are present in the Doxygen XML,
so they do need to be excluded. Now we include static functions if their
body is in a header. We de not scan private headers, so they must be
public API.

Comparing the final generated HTML documentation, these functions are
added to both Client and Server APIs:

  wl_fixed_to_double
  wl_fixed_from_double
  wl_fixed_to_int
  wl_fixed_from_int

These functions are added to the Server API:

  wl_signal_init
  wl_signal_add
  wl_signal_get
  wl_signal_emit

Signed-off-by: Pekka Paalanen <pq@iki.fi>
---
 doc/publican/xsl/doxygen-to-publican.xsl | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/doc/publican/xsl/doxygen-to-publican.xsl b/doc/publican/xsl/doxygen-to-publican.xsl
index e13dcd7..0387372 100644
--- a/doc/publican/xsl/doxygen-to-publican.xsl
+++ b/doc/publican/xsl/doxygen-to-publican.xsl
@@ -101,8 +101,16 @@
 
 <!-- methods -->
 <xsl:template match="memberdef" >
-  <xsl:if test="@kind = 'function' and @static = 'no' and @prot = 'public' or
-                @kind !='function' and normalize-space(briefdescription) != ''">
+  <xsl:if test="(@kind = 'function' and
+                 (@static = 'no' or
+                  substring(location/@bodyfile,
+                            string-length(location/@bodyfile) - 1,
+                            1000) = '.h'
+                 )
+                 and @prot = 'public'
+                )
+                or
+                (@kind != 'function' and normalize-space(briefdescription) != '')">
     <varlistentry id="{$which}-{@id}">
         <term>
           <xsl:value-of select="name"/>
-- 
cgit v1.2.3-70-g09d2