rpms/dbus/devel dbus-1.0.1-generate-xml-docs.patch, NONE, 1.1 doxygen_to_devhelp.xsl, NONE, 1.1 dbus.spec, 1.112, 1.113

Sun Nov 26 05:12:20 UTC 2006

Author: mclasen

Update of /cvs/dist/rpms/dbus/devel
In directory cvs.devel.redhat.com:/tmp/cvs-serv7348

Modified Files:
	dbus.spec 
Added Files:
	dbus-1.0.1-generate-xml-docs.patch doxygen_to_devhelp.xsl 
Log Message:
include docs


dbus-1.0.1-generate-xml-docs.patch:
 Doxyfile.in |    2 +-
 1 files changed, 1 insertion(+), 1 deletion(-)

--- NEW FILE dbus-1.0.1-generate-xml-docs.patch ---
--- dbus-1.0.1/Doxyfile.in.generate-xml-docs	2006-11-25 23:42:59.000000000 -0500
+++ dbus-1.0.1/Doxyfile.in	2006-11-25 23:43:12.000000000 -0500
@@ -133,7 +133,7 @@
 #---------------------------------------------------------------------------
 # configuration options related to the XML output
 #---------------------------------------------------------------------------
-GENERATE_XML           = NO
+GENERATE_XML           = YES
 #---------------------------------------------------------------------------
 # Configuration options related to the preprocessor   
 #---------------------------------------------------------------------------


--- NEW FILE doxygen_to_devhelp.xsl ---
<xsl:stylesheet
    xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
    xmlns:fo="http://www.w3.org/1999/XSL/Format"
    version="1.0">

<xsl:output method="xml" version="1.0" indent="yes"/>

<xsl:param name="prefix"></xsl:param>

<xsl:template match="/">
  <book title="D-Bus: A system for interprocess communication"
        name="dbus"
        link="dbus-tutorial.html">
  <chapters>
     <sub name="Tutorial" link="{$prefix}dbus-tutorial.html"/>
     <sub name="FAQ" link="{$prefix}dbus-faq.html"/>
     <sub name="Specification" link="{$prefix}dbus-specification.html"/>
     <sub name="API Reference" link="{$prefix}api/index.html"/>
  </chapters>

  <functions>
    <xsl:apply-templates select="doxygenindex/compound[@kind='group']/member[@kind='function']"/>
  </functions>
  </book>
</xsl:template>

<xsl:template match="member">
  <xsl:param name="name"><xsl:value-of select="name"/></xsl:param>
  <xsl:if test="starts-with($name,'dbus') or starts-with($name, 'DBus')">
    <xsl:param name="refid"><xsl:value-of select="@refid"/></xsl:param>
    <xsl:if test="starts-with($refid,'group__') and contains($refid, '_1')">
       <xsl:param name="before"><xsl:value-of select="substring-before($refid,'_1')"/></xsl:param>
       <xsl:param name="after"><xsl:value-of select="substring-after($refid,'_1')"/></xsl:param>
       <xsl:param name="link"><xsl:value-of select="$before"/>.html#<xsl:value-of select="$after"/></xsl:param>
       <function name="{$name}" link="{$prefix}api/{$link}"/>
    </xsl:if>
  </xsl:if>
</xsl:template>

</xsl:stylesheet>


Index: dbus.spec
===================================================================
RCS file: /cvs/dist/rpms/dbus/devel/dbus.spec,v
retrieving revision 1.112
retrieving revision 1.113
diff -u -r1.112 -r1.113
--- dbus.spec	20 Nov 2006 19:03:07 -0000	1.112
+++ dbus.spec	26 Nov 2006 05:12:17 -0000	1.113
@@ -8,9 +8,10 @@
 Summary: D-BUS message bus
 Name: dbus
 Version: 1.0.1 
-Release: 1%{?dist}
+Release: 2%{?dist}
 URL: http://www.freedesktop.org/software/dbus/
 Source0: http://dbus.freedesktop.org/releases/dbus/%{name}-%{version}.tar.gz
+Source1: doxygen_to_devhelp.xsl
 License: AFL/GPL
 Group: System Environment/Libraries
 BuildRoot: %{_tmppath}/%{name}-root
@@ -24,6 +25,9 @@
 BuildRequires: libX11-devel
 BuildRequires: libcap-devel
 BuildRequires: gettext
+BuildRequires: doxygen
+BuildRequires: xmlto
+BuildRequires: libxslt
 Requires: libselinux >= %{libselinux_version}
 Requires: libxml2-python
 
@@ -33,6 +37,7 @@
 Patch1: dbus-0.60-start-early.patch
 Patch2: dbus-0.92-audit-system.patch
 Patch3: dbus-1.0.1-pthread-holder-fix.patch
+Patch4: dbus-1.0.1-generate-xml-docs.patch
 
 %description
 
@@ -67,6 +72,7 @@
 %patch1 -p1 -b .start-early
 %patch2 -p1 -b .audit_system
 %patch3 -p1 -b .pthread-holder-fix
+%patch4 -p1 -b .generate-xml-docs
 autoreconf -f -i
 
 %build
@@ -81,9 +87,13 @@
 
 # leave verbose mode so people can debug their apps but make sure to
 # turn it off on stable releases with --disable-verbose-mode
-%configure $COMMON_ARGS --disable-tests --disable-asserts
+%configure $COMMON_ARGS --disable-tests --disable-asserts --enable-doxygen-docs --enable-xml-docs
 make
 
+doxygen Doxyfile
+
+xsltproc -o dbus.devhelp %{SOURCE1} doc/api/xml/index.xml
+
 %install
 rm -rf %{buildroot}
 
@@ -103,6 +113,15 @@
 rm -f $RPM_BUILD_ROOT/%{_lib}/*.a
 rm -f $RPM_BUILD_ROOT/%{_lib}/*.la
 
+mkdir -p $RPM_BUILD_ROOT%{_datadir}/devhelp/books/dbus
+mkdir -p $RPM_BUILD_ROOT%{_datadir}/devhelp/books/dbus/api
+
+cp dbus.devhelp $RPM_BUILD_ROOT%{_datadir}/devhelp/books/dbus
+cp doc/dbus-specification.html $RPM_BUILD_ROOT%{_datadir}/devhelp/books/dbus
+cp doc/dbus-faq.html $RPM_BUILD_ROOT%{_datadir}/devhelp/books/dbus
+cp doc/dbus-tutorial.html $RPM_BUILD_ROOT%{_datadir}/devhelp/books/dbus
+cp doc/api/html/* $RPM_BUILD_ROOT%{_datadir}/devhelp/books/dbus/api
+
 ## %find_lang %{gettext_package}
 
 %clean
@@ -147,7 +166,6 @@
 %{_datadir}/man/man*/*
 %{_datadir}/dbus-1/services
 
-
 %files x11
 %defattr(-,root,root)
 
@@ -160,8 +178,12 @@
 %{_libdir}/dbus-1.0/include/
 %{_libdir}/pkgconfig/dbus-1.pc
 %{_includedir}/*
+%{_datadir}/devhelp/books/dbus
 
 %changelog
+* Sun Nov 26 2006 Matthias Clasen <mclasen at redhat.com> - 1.0.1-2
+- Include docs, and make them show up in devhelp
+
 * Mon Nov 20 2006 Ray Strode <rstrode at redhat.com> - 1.0.1-1
 - Update to 1.0.1
 - Apply patch from Thiago Macieira <thiago at kde.org> to 


