From b628c0e8dc12c0cbe9be26528b3710d9fdab52ec Mon Sep 17 00:00:00 2001
From: =?utf8?q?Ale=C5=A1=20K=C5=99enek?= <ljocha@ics.muni.cz>
Date: Thu, 24 Feb 2005 19:27:53 +0000
Subject: [PATCH] Generate UG section. Partially done

---
 org.glite.lb.ws-interface/Makefile        |  6 ++-
 org.glite.lb.ws-interface/src/LB.xml.T    | 10 +++--
 org.glite.lb.ws-interface/src/puke-ug.xsl | 67 +++++++++++++++++++------------
 3 files changed, 53 insertions(+), 30 deletions(-)

diff --git a/org.glite.lb.ws-interface/Makefile b/org.glite.lb.ws-interface/Makefile
index aacc67c..2b06e8c 100644
--- a/org.glite.lb.ws-interface/Makefile
+++ b/org.glite.lb.ws-interface/Makefile
@@ -59,5 +59,9 @@ clean:
 	${AT3} $< >$@ || rm -f $@
 	chmod -w $@ >/dev/null
 
-${WSDL}: LB.xml
+${WSDL}: LB.xml puke-wsdl.xsl
 	${XSLTPROC} ../src/puke-wsdl.xsl LB.xml >$@
+
+
+LB-ug.xml: LB.xml puke-ug.xsl
+	${XSLTPROC} ../src/puke-ug.xsl LB.xml >$@
diff --git a/org.glite.lb.ws-interface/src/LB.xml.T b/org.glite.lb.ws-interface/src/LB.xml.T
index a96551b..6f5895e 100644
--- a/org.glite.lb.ws-interface/src/LB.xml.T
+++ b/org.glite.lb.ws-interface/src/LB.xml.T
@@ -90,13 +90,15 @@
 		</struct>
 
 		<struct name="tagValue">
-			<elem name="tag" type="xsd:string"/>
-			<elem name="value" type="xsd:string" optional="yes"/>
+			Value of a single user tag.
+			<elem name="tag" type="xsd:string">Tag name</elem>
+			<elem name="value" type="xsd:string" optional="yes">Tag value</elem>
 		</struct>
 
 		<struct name="timeval">
-			<elem name="tvSec" type="xsd:long"/>
-			<elem name="tvUsec" type="xsd:long"/>
+			UNIX time representation.
+			<elem name="tvSec" type="xsd:long">Seconds since Jan 1 1970</elem>
+			<elem name="tvUsec" type="xsd:long">Microseconds</elem>
 		</struct>
 
 
diff --git a/org.glite.lb.ws-interface/src/puke-ug.xsl b/org.glite.lb.ws-interface/src/puke-ug.xsl
index 8daaf3a..14c558d 100644
--- a/org.glite.lb.ws-interface/src/puke-ug.xsl
+++ b/org.glite.lb.ws-interface/src/puke-ug.xsl
@@ -13,9 +13,9 @@
 		<title><xsl:value-of select="@name"/></title>
 		<para> <xsl:value-of select="text()"/> </para>
 		<sect1>
-			<title>Operation summary</title>
+			<title>Operations</title>
 				<itemizedlist>
-					<xsl:apply-templates select="op" mode="summary"/>
+					<xsl:apply-templates select="op"/>
 				</itemizedlist>
 		</sect1>
 	
@@ -24,16 +24,13 @@
 			<xsl:apply-templates select="types"/>
 		</sect1>
 	
-		<sect1>
-			<title>Operation detail</title>
-			<xsl:apply-templates select="op" mode="detail"/>
-		</sect1>
 	</chapter>
 	
 </xsl:template>
 
-<xsl:template match="op" mode="summary">
+<xsl:template match="op" >
 	<listitem>
+		<para>
 		<funcsynopsis>
 			<funcprototype>
 				<funcdef>
@@ -50,6 +47,8 @@
 				</xsl:for-each>
 			</funcprototype>
 		</funcsynopsis>
+		</para>
+		<para> <xsl:value-of select="text()"/> </para>
 	</listitem>
 </xsl:template>
 
@@ -59,24 +58,42 @@
 <xsl:template match="types">
 	<xsl:for-each select="flags|enum|struct">
 		<xsl:sort select="@name"/>
-		<xsl:choose>
-			<xsl:when test="name(.)='struct'">
-				<variablelist>
-					<title>Complex type <classname><xsl:value-of select="@name"/></classname></title>
-					<xsl:for-each select="elem">
-						<varlistentry>
-							<term>
-								<type><xsl:value-of select="@type"/></type>
-								<structfield><xsl:value-of select="@name"/></structfield>
-							</term>
-							<listitem>
-								<para><xsl:value-of select="text()"/></para>
-							</listitem>
-						</varlistentry>
-					</xsl:for-each>
-				</variablelist>
-			</xsl:when>
-		</xsl:choose>
+		<sect2>
+			<title> <xsl:value-of select="@name"/> </title>
+			<xsl:choose>
+				<xsl:when test="name(.)='struct'">
+					<para> <emphasis>Structure</emphasis> (sequence complex type in WSDL)</para>
+				</xsl:when>
+				<xsl:when test="name(.)='enum'">
+					<para> <emphasis>Enumeration</emphasis> (restriction of xsd:string in WSDL)</para>
+				</xsl:when>
+				<xsl:when test="name(.)='flags'">
+					<para> <emphasis>Flags</emphasis> (sequence of restricted xsd:string in WSDL)</para>
+				</xsl:when>
+			</xsl:choose>
+			<para> <xsl:value-of select="text()"/> </para>
+			<variablelist>
+				<xsl:for-each select="elem|val">
+					<varlistentry>
+						<term>
+							<xsl:choose>
+								<xsl:when test="name(.)='elem'">
+									<type><xsl:value-of select="@type"/></type>
+									<xsl:value-of select="' '"/>
+									<structfield><xsl:value-of select="@name"/></structfield>
+								</xsl:when>
+								<xsl:otherwise>
+									<constant><xsl:value-of select="@name"/></constant>
+								</xsl:otherwise>
+							</xsl:choose>
+						</term>
+						<listitem>
+							<simpara><xsl:value-of select="text()"/></simpara>
+						</listitem>
+					</varlistentry>
+				</xsl:for-each>
+			</variablelist>
+		</sect2>
 	</xsl:for-each>
 </xsl:template>
 
-- 
1.8.2.3