From 8f8a9f01909ba29e2b781310baeeaaddc3f15f0d Mon Sep 17 00:00:00 2001
From: "Gerald W. Carter" <jerry@samba.org>
Date: Tue, 22 Apr 2008 10:09:40 -0500
Subject: Moving docs tree to docs-xml to make room for generated docs in the
 release tarball. (This used to be commit
 9f672c26d63955f613088489c6efbdc08b5b2d14)

---
 docs-xml/xslt/expand-smbconfdoc.xsl | 168 ++++++++++++++++++++++++++++++++++++
 1 file changed, 168 insertions(+)
 create mode 100644 docs-xml/xslt/expand-smbconfdoc.xsl

(limited to 'docs-xml/xslt/expand-smbconfdoc.xsl')

diff --git a/docs-xml/xslt/expand-smbconfdoc.xsl b/docs-xml/xslt/expand-smbconfdoc.xsl
new file mode 100644
index 0000000000..5472d61a9a
--- /dev/null
+++ b/docs-xml/xslt/expand-smbconfdoc.xsl
@@ -0,0 +1,168 @@
+<?xml version='1.0'?>
+<!-- 
+	smb.conf-documentation specific stylesheets
+	Published under the GNU GPL
+
+	(C) Jelmer Vernooij 					2002-2004
+	(C) Alexander Bokovoy 					2002-2004
+-->
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+	xmlns:samba="http://www.samba.org/samba/DTD/samba-doc"
+	version="1.1">
+
+	<xsl:template match="description"><xsl:apply-templates/></xsl:template>
+
+	<xsl:template match="value"><xsl:element name="literal"><xsl:apply-templates/></xsl:element></xsl:template>
+	
+	<xsl:template match="command"><xsl:element name="literal"><xsl:apply-templates/></xsl:element></xsl:template>
+
+	<xsl:template match="synonym"><xsl:apply-templates/></xsl:template>
+
+	<xsl:template match="related"><xsl:element name="para"><xsl:text>Related command</xsl:text><xsl:apply-templates/></xsl:element></xsl:template>
+
+	<xsl:template match="samba:parameterlist">
+		<xsl:apply-templates>
+			<xsl:sort select="samba:parameter/@name"/>
+		</xsl:apply-templates>
+	</xsl:template>
+
+	<xsl:template match="value/comment">
+		<xsl:text>&#10;# </xsl:text>
+		<xsl:apply-templates/>
+	</xsl:template>
+
+	<xsl:template match="samba:parameter">
+		<xsl:variable name="cname"><xsl:value-of select="translate(translate(string(@name),' ',''),
+				'abcdefghijklmnopqrstuvwxyz','ABCDEFGHIJKLMNOPQRSTUVWXYZ')"/>
+		</xsl:variable>
+
+		<xsl:variable name="name"><xsl:value-of select="@name"/></xsl:variable>
+
+		<xsl:variable name="anchor">
+			<xsl:element name="anchor">
+				<xsl:attribute name="id">
+					<xsl:value-of select="$cname"/>
+				</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="indexterm">
+				<xsl:copy-of select="$anchor"/>
+				<xsl:value-of select="@name"/>
+				<xsl:value-of select="$context"/>
+			</xsl:element>
+		</xsl:variable>
+
+
+		<!-- Generate list of examples -->
+		<xsl:variable name="examples">
+			<xsl:for-each select="value">
+				<xsl:if test="@type = 'example'">
+					<xsl:element name="para">
+						<xsl:text>Example: </xsl:text>
+						<xsl:element name="emphasis">
+							<xsl:element name="parameter">
+								<xsl:copy-of select="$name"/>
+							</xsl:element>
+							<xsl:text> = </xsl:text>
+							<xsl:apply-templates select="."/>
+							<xsl:text>&#10;</xsl:text>
+						</xsl:element>
+						<xsl:text>&#10;</xsl:text>
+					</xsl:element>
+				</xsl:if>
+			</xsl:for-each>
+		</xsl:variable>
+
+		<xsl:variable name="tdefault">
+			<xsl:for-each select="value">
+				<xsl:if test="@type = 'default'">
+					<xsl:element name="para">
+						<xsl:text>Default: </xsl:text>
+						<xsl:element name="emphasis">
+							<xsl:element name="parameter">
+								<xsl:copy-of select="$name"/>
+							</xsl:element>
+							<xsl:text> = </xsl:text>
+							<xsl:apply-templates select="."/>
+							<xsl:text>&#10;</xsl:text>
+						</xsl:element>
+						<xsl:text>&#10;</xsl:text>
+					</xsl:element>
+				</xsl:if>
+			</xsl:for-each>
+		</xsl:variable>
+
+		<xsl:variable name="default">
+			<xsl:choose>
+				<xsl:when test="$tdefault = ''">
+					<xsl:element name="para">
+						<xsl:element name="emphasis">
+							<xsl:text>No default</xsl:text>
+						</xsl:element>	
+					</xsl:element>
+				</xsl:when>
+				<xsl:otherwise>
+					<xsl:copy-of select="$tdefault"/>
+				</xsl:otherwise>
+			</xsl:choose>
+		</xsl:variable>
+
+		<xsl:variable name="content">
+			<xsl:apply-templates select="description"/>
+		</xsl:variable>
+
+		<xsl:for-each select="synonym">
+			<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="."/>
+					</xsl:element>
+					<xsl:element name="see">
+						<xsl:value-of select="$name"/>
+					</xsl:element>
+				</xsl:element>
+				<xsl:element name="term">
+					<xsl:element name="anchor">
+						<xsl:attribute name="id">
+							<xsl:value-of select="translate(translate(string(.),' ',''), 'abcdefghijklmnopqrstuvwxyz','ABCDEFGHIJKLMNOPQRSTUVWXYZ')"/>
+						</xsl:attribute>
+					</xsl:element>
+					<xsl:value-of select="."/>
+				</xsl:element>
+				<xsl:element name="listitem">
+					<xsl:element name="para"><xsl:text>This parameter is a synonym for </xsl:text><xsl:copy-of select="$name"/><xsl:text>.</xsl:text></xsl:element>
+				</xsl:element>
+			</xsl:element>
+		</xsl:for-each>
+
+		<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:element name="listitem">
+				<xsl:copy-of select="$content"/> <xsl:text>&#10;</xsl:text>
+				<xsl:copy-of select="$default"/> <xsl:text>&#10;</xsl:text>
+				<xsl:copy-of select="$examples"/> <xsl:text>&#10;</xsl:text>
+			</xsl:element>
+		</xsl:element>
+	</xsl:template>
+</xsl:stylesheet>
-- 
cgit 


From 3be9a355ff2ab1f11dbf07542ae9ed2c013854cc Mon Sep 17 00:00:00 2001
From: Alexander Bokovoy <ab@samba.org>
Date: Thu, 24 Apr 2008 23:40:51 +0400
Subject: Fix documentation build: manpages, links in the HTML documents.

Fixed manpages generation to properly create handle smb.conf parameters' titles
Changed HTML generator to include links for every smb.conf parameter.
Now we have correct linking between different HTML documents.


Signed-off-by: Alexander Bokovoy <ab@samba.org>
(This used to be commit 056935ff1f5fefc3ca42f7006182fc80c94d91ab)
---
 docs-xml/xslt/expand-smbconfdoc.xsl | 63 +++++++++++++++++++++++--------------
 1 file changed, 40 insertions(+), 23 deletions(-)

(limited to 'docs-xml/xslt/expand-smbconfdoc.xsl')

diff --git a/docs-xml/xslt/expand-smbconfdoc.xsl b/docs-xml/xslt/expand-smbconfdoc.xsl
index 5472d61a9a..3e3dbe19fb 100644
--- a/docs-xml/xslt/expand-smbconfdoc.xsl
+++ b/docs-xml/xslt/expand-smbconfdoc.xsl
@@ -53,11 +53,11 @@
 		</xsl:variable>
 
 		<xsl:variable name="term">
-			<xsl:element name="indexterm">
 				<xsl:copy-of select="$anchor"/>
-				<xsl:value-of select="@name"/>
-				<xsl:value-of select="$context"/>
-			</xsl:element>
+				<xsl:element name="title">
+					<xsl:value-of select="@name"/>
+					<xsl:value-of select="$context"/>
+				</xsl:element>
 		</xsl:variable>
 
 
@@ -120,8 +120,7 @@
 		</xsl:variable>
 
 		<xsl:for-each select="synonym">
-			<xsl:element name="varlistentry">
-				<xsl:text>&#10;</xsl:text>     
+			<xsl:element name="section">
 				<xsl:element name="indexterm">
 					<xsl:attribute name="significance">
 						<xsl:text>preferred</xsl:text>
@@ -133,7 +132,7 @@
 						<xsl:value-of select="$name"/>
 					</xsl:element>
 				</xsl:element>
-				<xsl:element name="term">
+				<xsl:element name="title">
 					<xsl:element name="anchor">
 						<xsl:attribute name="id">
 							<xsl:value-of select="translate(translate(string(.),' ',''), 'abcdefghijklmnopqrstuvwxyz','ABCDEFGHIJKLMNOPQRSTUVWXYZ')"/>
@@ -141,28 +140,46 @@
 					</xsl:element>
 					<xsl:value-of select="."/>
 				</xsl:element>
-				<xsl:element name="listitem">
-					<xsl:element name="para"><xsl:text>This parameter is a synonym for </xsl:text><xsl:copy-of select="$name"/><xsl:text>.</xsl:text></xsl:element>
+				<xsl:element name="variablelist">
+					<xsl:element name="varlistentry">
+						<xsl:element name="listitem">
+							<xsl:element name="para">
+								<xsl:text>This parameter is a synonym for </xsl:text>
+								<xsl:element name="link">
+									<xsl:attribute name="linkend">
+										<xsl:value-of select="translate(translate(string($name),' ',''), 'abcdefghijklmnopqrstuvwxyz','ABCDEFGHIJKLMNOPQRSTUVWXYZ')"/>
+									</xsl:attribute>
+									<xsl:value-of select="$name"/>
+								</xsl:element>
+								<xsl:text>.</xsl:text>
+							</xsl:element>
+						</xsl:element>
+					</xsl:element>
 				</xsl:element>
+				<xsl:text>&#10;</xsl:text>     
 			</xsl:element>
 		</xsl:for-each>
 
-		<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 name="section">
+					<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:element name="variablelist">
+				<xsl:element name="varlistentry">
+					<xsl:element name="listitem">
+						<xsl:copy-of select="$content"/> <xsl:text>&#10;</xsl:text>
+						<xsl:copy-of select="$default"/> <xsl:text>&#10;</xsl:text>
+						<xsl:copy-of select="$examples"/> <xsl:text>&#10;</xsl:text>
+					</xsl:element>
 				</xsl:element>
 			</xsl:element>
-			<xsl:copy-of select="$term"/>
-			<xsl:element name="listitem">
-				<xsl:copy-of select="$content"/> <xsl:text>&#10;</xsl:text>
-				<xsl:copy-of select="$default"/> <xsl:text>&#10;</xsl:text>
-				<xsl:copy-of select="$examples"/> <xsl:text>&#10;</xsl:text>
-			</xsl:element>
+			<xsl:text>&#10;</xsl:text>
 		</xsl:element>
 	</xsl:template>
 </xsl:stylesheet>
-- 
cgit 


From 11e8b58bdfbb5d6d23f9361f991cde0742f4f2c8 Mon Sep 17 00:00:00 2001
From: Michael Adam <obnox@samba.org>
Date: Fri, 25 Apr 2008 14:01:57 +0200
Subject: docs: fix indentation in expand-smbxonfdoc.

Michael
(This used to be commit 79f53a06820b226cbfbc939ae9a6d255e4a4a2d1)
---
 docs-xml/xslt/expand-smbconfdoc.xsl | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

(limited to 'docs-xml/xslt/expand-smbconfdoc.xsl')

diff --git a/docs-xml/xslt/expand-smbconfdoc.xsl b/docs-xml/xslt/expand-smbconfdoc.xsl
index 3e3dbe19fb..38c63d96a4 100644
--- a/docs-xml/xslt/expand-smbconfdoc.xsl
+++ b/docs-xml/xslt/expand-smbconfdoc.xsl
@@ -161,15 +161,15 @@
 		</xsl:for-each>
 
 		<xsl:element name="section">
-					<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: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:element name="variablelist">
 				<xsl:element name="varlistentry">
 					<xsl:element name="listitem">
-- 
cgit 


From 6d3c61c9e74ea506e549e7a79fa103cf92a25274 Mon Sep 17 00:00:00 2001
From: Michael Adam <obnox@samba.org>
Date: Fri, 25 Apr 2008 14:08:10 +0200
Subject: docs: fix the manpage output of parameters list in smb.conf.5.

There were some newlines missing in the template for samba:parameters.

Michael
(This used to be commit a47abfa9276765164870bd7541798ff1201379b1)
---
 docs-xml/xslt/expand-smbconfdoc.xsl | 3 +++
 1 file changed, 3 insertions(+)

(limited to 'docs-xml/xslt/expand-smbconfdoc.xsl')

diff --git a/docs-xml/xslt/expand-smbconfdoc.xsl b/docs-xml/xslt/expand-smbconfdoc.xsl
index 38c63d96a4..5b2de1ce1f 100644
--- a/docs-xml/xslt/expand-smbconfdoc.xsl
+++ b/docs-xml/xslt/expand-smbconfdoc.xsl
@@ -55,8 +55,11 @@
 		<xsl:variable name="term">
 				<xsl:copy-of select="$anchor"/>
 				<xsl:element name="title">
+					<xsl:text>&#10;</xsl:text>
+					<xsl:text>&#10;</xsl:text>
 					<xsl:value-of select="@name"/>
 					<xsl:value-of select="$context"/>
+					<xsl:text>&#10;</xsl:text>
 				</xsl:element>
 		</xsl:variable>
 
-- 
cgit 


From 22f51b5d0046bee596475a6d3c535fb20d89b25b Mon Sep 17 00:00:00 2001
From: Karolin Seeger <kseeger@samba.org>
Date: Mon, 9 Jun 2008 15:05:26 +0200
Subject: man pages: Fix synonyms.

Karolin
(This used to be commit d1ae27ddbe9c30996d2c593a37e65581c3ff482c)
---
 docs-xml/xslt/expand-smbconfdoc.xsl | 3 +++
 1 file changed, 3 insertions(+)

(limited to 'docs-xml/xslt/expand-smbconfdoc.xsl')

diff --git a/docs-xml/xslt/expand-smbconfdoc.xsl b/docs-xml/xslt/expand-smbconfdoc.xsl
index 5b2de1ce1f..617d490ce9 100644
--- a/docs-xml/xslt/expand-smbconfdoc.xsl
+++ b/docs-xml/xslt/expand-smbconfdoc.xsl
@@ -136,12 +136,15 @@
 					</xsl:element>
 				</xsl:element>
 				<xsl:element name="title">
+				<xsl:text>&#10;</xsl:text>
+				<xsl:text>&#10;</xsl:text>
 					<xsl:element name="anchor">
 						<xsl:attribute name="id">
 							<xsl:value-of select="translate(translate(string(.),' ',''), 'abcdefghijklmnopqrstuvwxyz','ABCDEFGHIJKLMNOPQRSTUVWXYZ')"/>
 						</xsl:attribute>
 					</xsl:element>
 					<xsl:value-of select="."/>
+					<xsl:text>&#10;</xsl:text>
 				</xsl:element>
 				<xsl:element name="variablelist">
 					<xsl:element name="varlistentry">
-- 
cgit