doc: remove duplicate entries from 'Functions' in api docs

Submitted by Frank Jozsa on Nov. 25, 2016, 11:24 a.m.

Details

Message ID 20161125112410.1115-1-fjozsa@aszoj.com
State New
Headers show
Series "doc: remove duplicate entries from 'Functions' in api docs" ( rev: 1 ) in Wayland

Not browsing as part of any series.

Commit Message

Frank Jozsa Nov. 25, 2016, 11:24 a.m.
Signed-off-by: Frank Jozsa <fjozsa@aszoj.com>
---
 doc/publican/doxygen-to-publican.xsl | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

Patch hide | download patch | download mbox

diff --git a/doc/publican/doxygen-to-publican.xsl b/doc/publican/doxygen-to-publican.xsl
index e13dcd7..7a7cb72 100644
--- a/doc/publican/doxygen-to-publican.xsl
+++ b/doc/publican/doxygen-to-publican.xsl
@@ -10,7 +10,7 @@ 
     <title>Functions</title>
     <para />
     <variablelist>
-      <xsl:apply-templates select="/doxygen/compounddef[@kind='file']/sectiondef/memberdef" />
+      <xsl:apply-templates select="/doxygen/compounddef[@kind='file'][not(@id = 'wayland-server_8c')][not(@id = 'wayland-client_8c')]/sectiondef/memberdef" />
     </variablelist>
   </section>
 

Comments

Hi Frank,

> On Nov 25, 2016, at 3:24 AM, Frank Jozsa <fjozsa@aszoj.com> wrote:
> 
> Signed-off-by: Frank Jozsa <fjozsa@aszoj.com>

Can you please explain the issue here and how this resolves it?
I applied your patch but couldn't quickly discern the difference in
the doxygen output. Was it to remove the "Functions" sections at the end
of both the Client and Server API pages? If so, this didn't seem to do it.

This also generates a new warning when generating the pages.

Thank you,
yong



> ---
> doc/publican/doxygen-to-publican.xsl | 2 +-
> 1 file changed, 1 insertion(+), 1 deletion(-)
> 
> diff --git a/doc/publican/doxygen-to-publican.xsl b/doc/publican/doxygen-to-publican.xsl
> index e13dcd7..7a7cb72 100644
> --- a/doc/publican/doxygen-to-publican.xsl
> +++ b/doc/publican/doxygen-to-publican.xsl
> @@ -10,7 +10,7 @@
>     <title>Functions</title>
>     <para />
>     <variablelist>
> -      <xsl:apply-templates select="/doxygen/compounddef[@kind='file']/sectiondef/memberdef" />
> +      <xsl:apply-templates select="/doxygen/compounddef[@kind='file'][not(@id = 'wayland-server_8c')][not(@id = 'wayland-client_8c')]/sectiondef/memberdef" />
>     </variablelist>
>   </section>
> 
> -- 
> 2.10.2
> 
> _______________________________________________
> wayland-devel mailing list
> wayland-devel@lists.freedesktop.org
> https://lists.freedesktop.org/mailman/listinfo/wayland-devel
Ah,

> On Nov 25, 2016, at 8:12 AM, Yong Bakos <junk@humanoriented.com> wrote:
> 
> Hi Frank,
> 
>> On Nov 25, 2016, at 3:24 AM, Frank Jozsa <fjozsa@aszoj.com> wrote:
>> 
>> Signed-off-by: Frank Jozsa <fjozsa@aszoj.com>
> 
> Can you please explain the issue here and how this resolves it?

I see the issue raised on IRC now. Will re-apply and try to review.
But there is that new warning, let's see if we can squelch that. There's
another existing warning prior to this patch that I'm resolving as well.

Thanks Frank,
yong


> I applied your patch but couldn't quickly discern the difference in
> the doxygen output. Was it to remove the "Functions" sections at the end
> of both the Client and Server API pages? If so, this didn't seem to do it.
> 
> This also generates a new warning when generating the pages.
> 
> Thank you,
> yong
> 
> 
> 
>> ---
>> doc/publican/doxygen-to-publican.xsl | 2 +-
>> 1 file changed, 1 insertion(+), 1 deletion(-)
>> 
>> diff --git a/doc/publican/doxygen-to-publican.xsl b/doc/publican/doxygen-to-publican.xsl
>> index e13dcd7..7a7cb72 100644
>> --- a/doc/publican/doxygen-to-publican.xsl
>> +++ b/doc/publican/doxygen-to-publican.xsl
>> @@ -10,7 +10,7 @@
>>    <title>Functions</title>
>>    <para />
>>    <variablelist>
>> -      <xsl:apply-templates select="/doxygen/compounddef[@kind='file']/sectiondef/memberdef" />
>> +      <xsl:apply-templates select="/doxygen/compounddef[@kind='file'][not(@id = 'wayland-server_8c')][not(@id = 'wayland-client_8c')]/sectiondef/memberdef" />
>>    </variablelist>
>>  </section>
>> 
>> -- 
>> 2.10.2
>> 
>> _______________________________________________
>> wayland-devel mailing list
>> wayland-devel@lists.freedesktop.org
>> https://lists.freedesktop.org/mailman/listinfo/wayland-devel
> 
> _______________________________________________
> wayland-devel mailing list
> wayland-devel@lists.freedesktop.org
> https://lists.freedesktop.org/mailman/listinfo/wayland-devel