syncing files from 3.0 into HEAD again

(This used to be commit bca0bba209255d0effbae6a3d3b6d298f0952c3a)

1 files changed, 304 insertions, 0 deletions

diff --git a/docs/docbook/xslt/expand-sambadoc.xsl b/docs/docbook/xslt/expand-sambadoc.xsl
new file mode 100644
index 0000000000..2749fdf3e9
--- /dev/null
+++ b/docs/docbook/xslt/expand-sambadoc.xsl
@@ -0,0 +1,304 @@
+<?xml version='1.0'?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+                xmlns:exsl="http://exslt.org/common"
+                xmlns:samba="http://samba.org/common"
+				version="1.1"
+                extension-element-prefixes="exsl">
+
+<xsl:output method="xml"/>
+
+<xsl:param name="xmlSambaNsUri" select="'http://samba.org/common'"/>
+
+<xsl:template match="reference/refentry/refsect1">
+	<xsl:if test="title!='VERSION' and title!='AUTHOR'">
+		<xsl:element name="refsect1">
+			<xsl:if test="@id!=''">
+				<xsl:attribute name="id">
+					<xsl:value-of select="@id"/>
+				</xsl:attribute>
+			</xsl:if>
+			<xsl:apply-templates/>			
+		</xsl:element>
+	</xsl:if>
+</xsl:template>
+
+<xsl:template match="reference/refentry">
+    <xsl:element name="section">
+        <xsl:attribute name="id">
+            <xsl:value-of select="@id"/>
+        </xsl:attribute>
+        <xsl:element name="title">
+            <xsl:value-of select="refmeta/refentrytitle"/>
+<!--			<xsl:text> (</xsl:text>
+			<xsl:value-of select="refnamediv/refpurpose"/>
+			<xsl:text>)</xsl:text>-->
+        </xsl:element>
+        <xsl:apply-templates/>
+    </xsl:element>
+</xsl:template>
+
+<xsl:template match="reference/refentry/refmeta"/>
+
+<xsl:template match="reference/refentry/refnamediv"/>
+
+<xsl:template match="reference">
+	<xsl:element name="appendix">
+		<xsl:attribute name="id">
+			<xsl:value-of select="@id"/>
+		</xsl:attribute>
+		<xsl:apply-templates/>
+	</xsl:element>
+</xsl:template>
+
+<xsl:template match="/node()">
+	<xsl:text disable-output-escaping="yes">
+&lt;!DOCTYPE </xsl:text><xsl:value-of select="name(.)"/><xsl:text disable-output-escaping="yes"> PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+	        "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+
+	&lt;!ENTITY % globalentities SYSTEM 'global.ent'> %globalentities;
+ ]>
+</xsl:text>
+<xsl:copy>
+    <xsl:attribute name="id"><xsl:value-of select="@id"/></xsl:attribute>
+    <xsl:apply-templates/>
+</xsl:copy>
+</xsl:template>
+
+
+<!-- This is needed to copy content unchanged -->
+<xsl:template match="@*|node()">
+
+  <xsl:copy>
+    <xsl:apply-templates select="@*|node()"/>
+  </xsl:copy>
+</xsl:template>
+
+<xsl:template match="smbconfexample/smbconfoption|smbconfblock/smbconfoption">
+	<xsl:element name="member">
+		<xsl:element name="parameter">
+			<xsl:value-of select="name"/>
+	    	<xsl:choose>
+		  	<xsl:when test="value != ''">
+				<xsl:text> = </xsl:text>
+				<xsl:value-of select="value"/>
+			</xsl:when>
+		  </xsl:choose>
+		</xsl:element>
+	</xsl:element>
+</xsl:template>
+
+<xsl:template match="smbconfexample/smbconfcomment|smbconfblock/smbconfcomment">
+	<xsl:element name="member">
+		<xsl:text># </xsl:text>
+		<xsl:apply-templates/>
+	</xsl:element>
+</xsl:template>
+
+<xsl:template match="smbconfexample/smbconfsection|smbconfblock/smbconfsection">
+	<xsl:element name="member">
+		<xsl:text> </xsl:text>
+	</xsl:element>
+	<xsl:element name="member">
+		<xsl:element name="parameter">
+			<xsl:apply-templates/>
+		</xsl:element>
+	</xsl:element>
+</xsl:template>
+
+<xsl:template match="smbconfoption">
+  <!-- Include an index term -->
+  <xsl:element name="indexterm">
+  	<xsl:element name="primary">
+		<xsl:value-of select="name"/>
+	</xsl:element>
+  </xsl:element>
+		
+<!-- FIXME: Do this only when smb.conf is included 
+  <xsl:element name="link">
+	  <xsl:attribute name="linkend">
+	  	<xsl:value-of select="translate(translate(string(name),' ',''),'abcdefghijklmnopqrstuvwxyz','ABCDEFGHIJKLMNOPQRSTUVWXYZ')"/>
+	  </xsl:attribute>-->
+
+	  <xsl:element name="parameter">
+	    <xsl:attribute name="moreinfo">
+		   <xsl:text>none</xsl:text>
+		</xsl:attribute>
+		<xsl:value-of select="name"/>	
+	  </xsl:element>
+
+	  <xsl:choose>
+	  	<xsl:when test="value != ''">
+			<xsl:text> = </xsl:text>
+			<xsl:value-of select="value"/>
+		</xsl:when>
+	  </xsl:choose>
+	  <!--
+  </xsl:element>-->
+</xsl:template>
+
+<!-- FIXME: Needs extension sometime -->
+<xsl:template match="ntgroup|ntuser">
+	<xsl:element name="emphasis">
+		<xsl:apply-templates/>
+	</xsl:element>
+</xsl:template>
+
+<xsl:template match="smbconfexample">
+ 	<xsl:choose>
+	  	<xsl:when test="title = ''">
+			<xsl:message>
+			<xsl:text>Warning: smbconfexample does not have title!</xsl:text>
+			</xsl:message>
+		</xsl:when>
+	</xsl:choose>
+	<xsl:element name="example">
+		<xsl:choose>
+			<xsl:when test="@id != ''">
+				<xsl:attribute name="id">
+					<xsl:value-of select="@id"/>
+				</xsl:attribute>
+			</xsl:when>
+		</xsl:choose>
+					
+		<xsl:element name="title">
+			<xsl:value-of select="title"/>
+		</xsl:element>
+		<xsl:element name="simplelist">
+			<xsl:apply-templates/>
+		</xsl:element>
+	</xsl:element>
+</xsl:template>
+
+<xsl:template match="smbconfexample/title">
+</xsl:template>
+
+<xsl:template match="smbconfblock">
+	<xsl:element name="simplelist">
+		<xsl:apply-templates/>
+	</xsl:element>
+</xsl:template>
+
+<xsl:template match="smbconfsection">
+	<xsl:element name="parameter">
+		<xsl:apply-templates/>
+	</xsl:element>
+</xsl:template>
+
+<xsl:template match="smbconfcomment">
+	<xsl:text># </xsl:text>
+	<xsl:apply-templates/>
+</xsl:template>
+
+<xsl:template match="image">
+	<xsl:element name="figure">
+		<xsl:attribute name="id">
+			<xsl:choose>
+				<xsl:when test="@id != ''">
+					<xsl:value-of select="@id"/>
+				</xsl:when>
+				<xsl:otherwise>
+					<xsl:value-of select="imagefile"/>
+				</xsl:otherwise>
+			</xsl:choose>
+		</xsl:attribute>
+			
+		<xsl:element name="title">
+			<xsl:value-of select="imagedescription"/>
+		</xsl:element>
+		<xsl:element name="mediaobject">
+			<xsl:element name="imageobject">
+				<xsl:attribute name="role"><xsl:text>latex</xsl:text></xsl:attribute>
+				<xsl:element name="imagedata">
+					<xsl:attribute name="fileref">
+						<xsl:text>projdoc/imagefiles/</xsl:text><xsl:value-of select="imagefile"/></xsl:attribute>
+					<xsl:attribute name="scale">
+						<xsl:choose>
+						    <xsl:when test="@scale != ''">
+								<xsl:value-of select="@scale"/>
+							</xsl:when>
+
+							<xsl:otherwise>
+								<xsl:text>50</xsl:text>
+							</xsl:otherwise>
+						</xsl:choose>
+					</xsl:attribute>
+					<xsl:attribute name="scalefit"><xsl:text>1</xsl:text></xsl:attribute>
+				</xsl:element>
+			</xsl:element>
+			<xsl:element name="imageobject">
+				<xsl:element name="imagedata">
+					<xsl:attribute name="fileref">
+						<xsl:text>projdoc/imagefiles/</xsl:text><xsl:value-of select="imagefile"/><xsl:text>.png</xsl:text></xsl:attribute>
+					<xsl:attribute name="scale"><xsl:text>50</xsl:text></xsl:attribute>
+					<xsl:attribute name="scalefit"><xsl:text>1</xsl:text></xsl:attribute>
+				</xsl:element>
+			</xsl:element>
+		</xsl:element>
+	</xsl:element>
+</xsl:template>
+
+<xsl:template match="//samba:parameter">
+  <!-- reconstruct varlistentry - not all of them will go into separate files
+       and also we must repair the main varlistentry itself.
+  -->
+  <xsl:variable name="name"><xsl:value-of select="translate(translate(string(@name),' ',''),
+                  'abcdefghijklmnopqrstuvwxyz','ABCDEFGHIJKLMNOPQRSTUVWXYZ')"/>
+  </xsl:variable>
+
+  <xsl:variable name="anchor">
+     <xsl:element name="anchor">
+        <xsl:attribute name="id">
+          <xsl:value-of select="$name"/>
+        </xsl:attribute>
+     </xsl:element>
+  </xsl:variable>
+
+  <xsl:variable name="context">
+     <xsl:text> (</xsl:text>
+     <xsl:value-of select="@context"/>
+     <xsl:text>)</xsl:text>
+  </xsl:variable>
+
+  <xsl:variable name="term">
+     <xsl:element name="term">
+          <xsl:copy-of select="$anchor"/>
+          <xsl:value-of select="@name"/>
+          <xsl:value-of select="$context"/>
+     </xsl:element>
+  </xsl:variable>
+
+  <xsl:variable name="content">
+       <xsl:apply-templates/>
+  </xsl:variable>
+  
+  <xsl:element name="varlistentry">
+     <xsl:text>&#10;</xsl:text>     
+     <xsl:element name="indexterm">
+     	<xsl:attribute name="significance">
+		<xsl:text>preferred</xsl:text>
+	</xsl:attribute>
+     	<xsl:element name="primary">
+	<xsl:value-of select="@name"/>
+	</xsl:element>
+     </xsl:element>
+     <xsl:copy-of select="$term"/>
+     <xsl:copy-of select="$content"/>
+     <xsl:text>
+</xsl:text>     
+  </xsl:element>
+
+</xsl:template>
+
+<xsl:template match="ulink">
+	<xsl:element name="ulink">
+		<xsl:attribute name="url">
+			<xsl:value-of select="@url"/>
+		</xsl:attribute>
+	
+		<xsl:apply-templates/>
+		
+	</xsl:element>
+</xsl:template>
+
+
+</xsl:stylesheet>