From ff5ea7b76a633d91c94d495c522a0bc5d86c184d Mon Sep 17 00:00:00 2001
From: Aleksander Morgado <aleksander@lanedo.com>
Date: Tue, 18 Oct 2011 20:08:08 +0200
Subject: [PATCH] build: setup autogeneration of names header for the new API

The `include/ModemManager-names.h' autogenerated header includes the list of
Interface, Method, Signal and Property names defined in the DBus API.
---
 .gitignore                         |   1 +
 build-aux/Makefile.am              |   3 +-
 build-aux/header-generator-new.xsl | 190 +++++++++++++++++++++++++++++
 include/Makefile.am                |  15 ++-
 new/all.xml                        |  18 +++
 5 files changed, 222 insertions(+), 5 deletions(-)
 create mode 100644 build-aux/header-generator-new.xsl
 create mode 100644 new/all.xml

diff --git a/.gitignore b/.gitignore
index 5ec4fc80..47a599d8 100644
--- a/.gitignore
+++ b/.gitignore
@@ -42,6 +42,7 @@ libqcdm/tests/test-qcdm
 libwmc/tests/test-wmc
 
 include/ModemManager.h
+include/ModemManager-names.h
 
 po/Makefile.in.in
 po/POTFILES
diff --git a/build-aux/Makefile.am b/build-aux/Makefile.am
index fdcf628c..86c7f890 100644
--- a/build-aux/Makefile.am
+++ b/build-aux/Makefile.am
@@ -1,3 +1,4 @@
 
 EXTRA_DIST = \
-	header-generator.xsl
+	header-generator.xsl \
+	header-generator-new.xsl
diff --git a/build-aux/header-generator-new.xsl b/build-aux/header-generator-new.xsl
new file mode 100644
index 00000000..4cd0dea0
--- /dev/null
+++ b/build-aux/header-generator-new.xsl
@@ -0,0 +1,190 @@
+<!-- Generate a C header file from the Modem Manager specification.
+
+Copyright (C) 2006, 2007 Collabora Limited
+Copyright (C) 2011 Google, Inc.
+
+This library is free software; you can redistribute it and/or
+modify it under the terms of the GNU Lesser General Public
+License as published by the Free Software Foundation; either
+version 2.1 of the License, or (at your option) any later version.
+
+This library is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public
+License along with this library; if not, write to the Free Software
+Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+-->
+<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+  xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0"
+  exclude-result-prefixes="tp">
+
+  <!--Don't move the declaration of the HTML namespace up here - XMLNSs
+  don't work ideally in the presence of two things that want to use the
+  absence of a prefix, sadly. -->
+
+  <xsl:strip-space elements="node interface"/>
+  <xsl:template match="*" mode="identity">
+    <xsl:copy>
+      <xsl:apply-templates mode="identity"/>
+    </xsl:copy>
+  </xsl:template>
+
+  <xsl:template match="signal">
+    <xsl:variable name="varname">
+      <xsl:value-of select="translate(@name,
+			    'abcdefghijklmnopqrstuvwxyz. ',
+			    'ABCDEFGHIJKLMNOPQRSTUVWXYZ_')"/>
+    </xsl:variable>
+    <xsl:variable name="intname">
+      <xsl:choose>
+        <xsl:when test="starts-with(../@name, 'org.freedesktop.ModemManager1.')">
+          <xsl:value-of select="translate(substring-after(../@name, 'org.freedesktop.ModemManager1.'),
+			       'abcdefghijklmnopqrstuvwxyz. ',
+			       'ABCDEFGHIJKLMNOPQRSTUVWXYZ_')"/>
+         </xsl:when>
+         <xsl:otherwise>
+           <xsl:text>MANAGER</xsl:text>
+         </xsl:otherwise>
+       </xsl:choose>
+    </xsl:variable>
+#define <xsl:value-of select="concat('MM_', $intname, '_SIGNAL_', $varname)"/> "<xsl:value-of select="@name"/>"</xsl:template>
+
+  <xsl:template match="property">
+    <xsl:variable name="varname">
+      <xsl:value-of select="translate(@name,
+			    'abcdefghijklmnopqrstuvwxyz. ',
+			    'ABCDEFGHIJKLMNOPQRSTUVWXYZ_')"/>
+    </xsl:variable>
+    <xsl:variable name="intname">
+      <xsl:choose>
+        <xsl:when test="starts-with(../@name, 'org.freedesktop.ModemManager1.')">
+          <xsl:value-of select="translate(substring-after(../@name, 'org.freedesktop.ModemManager1.'),
+			       'abcdefghijklmnopqrstuvwxyz. ',
+			       'ABCDEFGHIJKLMNOPQRSTUVWXYZ_')"/>
+         </xsl:when>
+         <xsl:otherwise>
+           <xsl:text>MANAGER</xsl:text>
+         </xsl:otherwise>
+       </xsl:choose>
+    </xsl:variable>
+#define <xsl:value-of select="concat('MM_', $intname, '_PROPERTY_', $varname)"/> "<xsl:value-of select="@name"/>"</xsl:template>
+
+  <xsl:template match="method">
+    <xsl:variable name="varname">
+      <xsl:value-of select="translate(@name,
+			    'abcdefghijklmnopqrstuvwxyz. ',
+                            'ABCDEFGHIJKLMNOPQRSTUVWXYZ_')"/>
+    </xsl:variable>
+    <xsl:variable name="intname">
+      <xsl:choose>
+        <xsl:when test="starts-with(../@name, 'org.freedesktop.ModemManager1.')">
+          <xsl:value-of select="translate(substring-after(../@name, 'org.freedesktop.ModemManager1.'),
+			       'abcdefghijklmnopqrstuvwxyz. ',
+			       'ABCDEFGHIJKLMNOPQRSTUVWXYZ_')"/>
+         </xsl:when>
+         <xsl:otherwise>
+           <xsl:text>MANAGER</xsl:text>
+         </xsl:otherwise>
+       </xsl:choose>
+    </xsl:variable>
+#define <xsl:value-of select="concat('MM_', $intname, '_METHOD_', $varname)"/> "<xsl:value-of select="@name"/>"</xsl:template>
+
+  <xsl:output method="text" indent="no" encoding="ascii"
+    omit-xml-declaration="yes" />
+
+  <xsl:template match="/tp:spec">
+/* Generated Header file do not edit */
+
+/*
+ * ModemManager Interface Specification
+ * Version 0.6
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ * Boston, MA 02110-1301 USA.
+ *
+ * Copyright (C) 2008 - 2009 Novell, Inc.
+ * Copyright (C) 2009 - 2011 Red Hat, Inc.
+ * Copyright (C) 2011 Google, Inc.
+ */
+
+#ifndef _MODEM_MANAGER_NAMES_H_
+#define _MODEM_MANAGER_NAMES_H_
+
+#define MM_DBUS_PATH    "/org/freedesktop/ModemManager1"
+#define MM_DBUS_SERVICE "org.freedesktop.ModemManager1"
+
+/**************
+ * Interfaces *
+ **************/
+<xsl:for-each select="node/interface">
+  <xsl:apply-templates select="tp:docstring"/>
+  <xsl:variable name="varname">
+    <xsl:choose>
+      <xsl:when test="starts-with(@name, 'org.freedesktop.ModemManager1.')">
+        <xsl:value-of select="translate(substring-after(@name, 'org.freedesktop.ModemManager1.'),
+                              'abcdefghijklmnopqrstuvwxyz. ',
+                              'ABCDEFGHIJKLMNOPQRSTUVWXYZ_')"/>
+      </xsl:when>
+      <xsl:otherwise>
+        <xsl:text></xsl:text>
+      </xsl:otherwise>
+    </xsl:choose>
+  </xsl:variable>
+  <xsl:variable name="prefix">
+    <xsl:choose>
+      <xsl:when test="string-length($varname) > 0">
+        <xsl:text>_</xsl:text>
+      </xsl:when>
+      <xsl:otherwise>
+        <xsl:text></xsl:text>
+      </xsl:otherwise>
+    </xsl:choose>
+  </xsl:variable>
+  <xsl:if test="starts-with(@name, 'org.freedesktop.ModemManager1')">
+#define <xsl:value-of select="concat('MM_DBUS_INTERFACE', $prefix, $varname)"/> "<xsl:value-of select="@name"/>"</xsl:if></xsl:for-each>
+
+/******************************
+ * Methods/Signals/Properties *
+ ******************************/
+<xsl:for-each select="node/interface">
+/*
+ * Interface '<xsl:value-of select="@name"/>'
+ */
+ <xsl:apply-templates select="method"/>
+ <xsl:if test="count(method[*])!=0">
+   <xsl:text></xsl:text>
+ </xsl:if>
+ <xsl:apply-templates select="signal"/>
+ <xsl:if test="count(signal[*])!=0">
+   <xsl:text></xsl:text>
+ </xsl:if>
+ <xsl:apply-templates select="property"/>
+ <xsl:if test="count(property[*])!=0">
+   <xsl:text></xsl:text>
+ </xsl:if>
+</xsl:for-each>
+
+#endif /*  _MODEM_MANAGER_NAMES_H_ */
+
+<!-- Ensure that the file ends with a newline -->
+<xsl:text>
+</xsl:text>
+</xsl:template>
+</xsl:stylesheet>
+
+<!-- vim:set sw=2 sts=2 et: -->
diff --git a/include/Makefile.am b/include/Makefile.am
index 03b6b934..6a9c564a 100644
--- a/include/Makefile.am
+++ b/include/Makefile.am
@@ -1,14 +1,21 @@
 XSLTPROC = xsltproc --xinclude --nonet
 
-XMLS = $(wildcard $(top_srcdir)/introspection/*.xml)
+OLD_XMLS = $(wildcard $(top_srcdir)/introspection/*.xml)
+NEW_XMLS = $(wildcard $(top_srcdir)/new/*.xml)
 
 includedir = @includedir@/mm
 
 include_HEADERS = \
+	ModemManager-names.h \
 	ModemManager.h
 
-ModemManager.h: $(XMLS) $(top_srcdir)/introspection/all.xml $(top_srcdir)/build-aux/header-generator.xsl
-	$(XSLTPROC) $(top_srcdir)/build-aux/header-generator.xsl $(top_srcdir)/introspection/all.xml > $@
+# NOTE: This is the header of the 0.5 API, which will get removed
+ModemManager.h: $(OLD_XMLS) $(top_srcdir)/introspection/all.xml $(top_srcdir)/build-aux/header-generator.xsl
+	$(AM_V_GEN) $(XSLTPROC) $(top_srcdir)/build-aux/header-generator.xsl $(top_srcdir)/introspection/all.xml > $@
+
+ModemManager-names.h: $(NEW_XMLS) $(top_srcdir)/new/all.xml $(top_srcdir)/build-aux/header-generator-new.xsl
+	$(AM_V_GEN) $(XSLTPROC) $(top_srcdir)/build-aux/header-generator-new.xsl $(top_srcdir)/new/all.xml > $@
 
 CLEANFILES = \
-	ModemManager.h
\ No newline at end of file
+	ModemManager-names.h \
+	ModemManager.h
diff --git a/new/all.xml b/new/all.xml
new file mode 100644
index 00000000..c6b3e4b8
--- /dev/null
+++ b/new/all.xml
@@ -0,0 +1,18 @@
+<tp:spec
+   xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0"
+   xmlns:xi="http://www.w3.org/2001/XInclude">
+
+  <xi:include href="org.freedesktop.ModemManager1.xml"/>
+  <xi:include href="org.freedesktop.ModemManager1.Sim.xml"/>
+  <xi:include href="org.freedesktop.ModemManager1.Bearer.xml"/>
+  <xi:include href="org.freedesktop.ModemManager1.Sms.xml"/>
+  <xi:include href="org.freedesktop.ModemManager1.Modem.xml"/>
+  <xi:include href="org.freedesktop.ModemManager1.Modem.3gpp.xml"/>
+  <xi:include href="org.freedesktop.ModemManager1.Modem.3gpp.Ussd.xml"/>
+  <xi:include href="org.freedesktop.ModemManager1.Modem.Cdma.xml"/>
+  <xi:include href="org.freedesktop.ModemManager1.Modem.Messaging.xml"/>
+  <xi:include href="org.freedesktop.ModemManager1.Modem.Location.xml"/>
+  <xi:include href="org.freedesktop.ModemManager1.Modem.Firmware.xml"/>
+  <xi:include href="org.freedesktop.ModemManager1.Modem.Contacts.xml"/>
+
+</tp:spec>