From bd30b6066f1a28663b28466a67064149b6e060a4 Mon Sep 17 00:00:00 2001
From: Alexander Bokovoy <ab@samba.org>
Date: Wed, 30 Apr 2003 21:39:49 +0000
Subject: Docbook XML conversion: XSLT and build infrastructure (This used to
 be commit f4f6e0b29e744077dfb836745716a659a49d7529)

---
 docs/docbook/smbdotconf/.cvsignore          |   1 -
 docs/docbook/smbdotconf/expand-smb.conf.xsl |  17 ++-
 docs/docbook/smbdotconf/man.xsl             | 159 ----------------------------
 docs/docbook/smbdotconf/process-all.sh      |  15 ---
 4 files changed, 15 insertions(+), 177 deletions(-)
 delete mode 100644 docs/docbook/smbdotconf/man.xsl
 delete mode 100755 docs/docbook/smbdotconf/process-all.sh

(limited to 'docs/docbook/smbdotconf')

diff --git a/docs/docbook/smbdotconf/.cvsignore b/docs/docbook/smbdotconf/.cvsignore
index 0f8c6cb0ed..e9d3f9c05a 100644
--- a/docs/docbook/smbdotconf/.cvsignore
+++ b/docs/docbook/smbdotconf/.cvsignore
@@ -1,4 +1,3 @@
 parameters.all.xml
 parameters.global.xml
 parameters.service.xml
-
diff --git a/docs/docbook/smbdotconf/expand-smb.conf.xsl b/docs/docbook/smbdotconf/expand-smb.conf.xsl
index 87b4898cf7..62fc4a9ccf 100644
--- a/docs/docbook/smbdotconf/expand-smb.conf.xsl
+++ b/docs/docbook/smbdotconf/expand-smb.conf.xsl
@@ -12,6 +12,20 @@
 
 <xsl:param name="xmlSambaNsUri" select="'http://samba.org/common'"/>
 
+<xsl:template match="refentry">
+<xsl:text disable-output-escaping="yes">
+&lt;!DOCTYPE refentry 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:element name="refentry">
+	<xsl:attribute name="id"><xsl:value-of select="@id"/></xsl:attribute>
+	<xsl:apply-templates/>
+</xsl:element>
+</xsl:template>
+
 <!-- This is needed to copy content unchanged -->
 <xsl:template match="@*|node()">
   <xsl:copy>
@@ -61,8 +75,7 @@
   </xsl:variable>
   
   <xsl:element name="varlistentry">
-     <xsl:text>
-</xsl:text>     
+     <xsl:text>&#10;</xsl:text>     
      <xsl:copy-of select="$term"/>
      <xsl:copy-of select="$content"/>
      <xsl:text>
diff --git a/docs/docbook/smbdotconf/man.xsl b/docs/docbook/smbdotconf/man.xsl
deleted file mode 100644
index a7ae76bbd8..0000000000
--- a/docs/docbook/smbdotconf/man.xsl
+++ /dev/null
@@ -1,159 +0,0 @@
-<?xml version='1.0'?>
-<!-- vim:set sts=2 shiftwidth=2 syntax=xml: -->
-<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
-                version='1.0'>
-
-<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl"/>
-
-<xsl:param name="chunk.section.depth" select="0"/>
-<xsl:param name="chunk.first.sections" select="1"/>
-<xsl:param name="use.id.as.filename" select="1"/>
-<xsl:param name="base.dir" select="'../../manpages/'"/>
-
-<!-- 
-    Our ulink stylesheet omits @url part if content was specified
--->
-<xsl:template match="ulink">
-  <xsl:variable name="content">
-    <xsl:apply-templates/>
-  </xsl:variable>
-  <xsl:if test="$content = ''">
-    <xsl:text>: </xsl:text>
-  </xsl:if>
-  <xsl:if test="$content != ''">
-    <xsl:value-of select="$content" />
-  </xsl:if>
-  <xsl:if test="$content = ''">
-    <xsl:apply-templates mode="italic" select="@url" />
-  </xsl:if>
-</xsl:template>
-
-<xsl:template match="refentry">
-
-  <xsl:variable name="section" select="refmeta/manvolnum"/>
-  <xsl:variable name="name" select="refnamediv/refname[1]"/>
-  <xsl:variable name="base.dir" select="$base.dir"/>
-  <!-- standard man page width is 64 chars; 6 chars needed for the two
-       (x) volume numbers, and 2 spaces, leaves 56 -->
-  <xsl:variable name="twidth" select="(74 - string-length(refmeta/refentrytitle)) div 2"/>
-
-  <xsl:variable name="reftitle" 
-		select="substring(refmeta/refentrytitle, 1, $twidth)"/>
-
-  <xsl:variable name="title">
-    <xsl:choose>
-      <xsl:when test="refentryinfo/title">
-        <xsl:value-of select="refentryinfo/title"/>
-      </xsl:when>
-      <xsl:when test="../referenceinfo/title">
-        <xsl:value-of select="../referenceinfo/title"/>
-      </xsl:when>
-    </xsl:choose>
-  </xsl:variable>
-
-  <xsl:variable name="date">
-    <xsl:choose>
-      <xsl:when test="refentryinfo/date">
-        <xsl:value-of select="refentryinfo/date"/>
-      </xsl:when>
-      <xsl:when test="../referenceinfo/date">
-        <xsl:value-of select="../referenceinfo/date"/>
-      </xsl:when>
-    </xsl:choose>
-  </xsl:variable>
-
-  <xsl:variable name="productname">
-    <xsl:choose>
-      <xsl:when test="refentryinfo/productname">
-        <xsl:value-of select="refentryinfo/productname"/>
-      </xsl:when>
-      <xsl:when test="../referenceinfo/productname">
-        <xsl:value-of select="../referenceinfo/productname"/>
-      </xsl:when>
-    </xsl:choose>
-  </xsl:variable>
-
-  <xsl:call-template name="write.text.chunk">
-    <xsl:with-param name="filename"
-		    select="concat($base.dir, normalize-space ($name), '.', $section)"/>
-    <xsl:with-param name="content">
-      <xsl:text>.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "</xsl:text>
-      <xsl:value-of select="translate($reftitle,'abcdefghijklmnopqrstuvwxyz', 'ABCDEFGHIJKLMNOPQRSTUVWXYZ')"/>
-      <xsl:text>" </xsl:text>
-      <xsl:value-of select="refmeta/manvolnum[1]"/>
-      <xsl:text> "</xsl:text>
-      <xsl:value-of select="normalize-space($date)"/>
-      <xsl:text>" "</xsl:text>
-      <xsl:value-of select="normalize-space($productname)"/>
-      <xsl:text>" "</xsl:text>
-      <xsl:value-of select="$title"/>
-      <xsl:text>"
-</xsl:text>
-      <xsl:apply-templates/>
-      <xsl:text>&#10;</xsl:text>
-
-      <!-- Author section -->
-      <xsl:choose>
-        <xsl:when test="refentryinfo//author">
-          <xsl:apply-templates select="refentryinfo" mode="authorsect"/>
-        </xsl:when>
-      </xsl:choose>
-    </xsl:with-param>
-  </xsl:call-template>
-</xsl:template>
-
-<xsl:template match="informalexample|screen|programlisting">
-  <xsl:text>.nf&#10;</xsl:text>
-  <xsl:apply-templates/>
-  <xsl:text>.fi&#10;</xsl:text>
-</xsl:template>
-
-<xsl:template match="//emphasis">
-  <xsl:text>\fB</xsl:text>
-  <xsl:apply-templates/>
-  <xsl:text>\fR</xsl:text>
-</xsl:template>
-
-<xsl:template match="para|simpara|remark" mode="list">
-  <xsl:variable name="foo">
-    <xsl:apply-templates/>
-  </xsl:variable>
-  <xsl:choose match="node()">
-    <!-- Don't normalize-space() for verbatim paragraphs        -->
-    <xsl:when test="informalexample|screen|programlisting">
-      <xsl:value-of select="$foo"/>
-    </xsl:when>
-    <xsl:otherwise>
-      <xsl:value-of select="normalize-space($foo)"/>
-      <xsl:text>&#10;</xsl:text>
-    </xsl:otherwise>
-  </xsl:choose>
-  <xsl:text>&#10;</xsl:text>
-  <xsl:if test="following-sibling::para or following-sibling::simpara or
-		following-sibling::remark">
-    <!-- Make sure multiple paragraphs within a list item don't -->
-    <!-- merge together.                                        -->
-    <xsl:text>&#10;</xsl:text>
-  </xsl:if>
-</xsl:template>
-
-</xsl:stylesheet>
diff --git a/docs/docbook/smbdotconf/process-all.sh b/docs/docbook/smbdotconf/process-all.sh
deleted file mode 100755
index 6d8c9941b4..0000000000
--- a/docs/docbook/smbdotconf/process-all.sh
+++ /dev/null
@@ -1,15 +0,0 @@
-#!/bin/sh
-sh generate-file-list.sh >parameters.all.xml
-
-xsltproc --xinclude \
-                 --param smb.context "'G'" \
-                 --output parameters.global.xml \
-                 generate-context.xsl parameters.all.xml
-
-xsltproc --xinclude \
-                 --param smb.context "'S'" \
-                 --output parameters.service.xml \
-                 generate-context.xsl parameters.all.xml
-
-xsltproc --xinclude expand-smb.conf.xsl smb.conf.5.xml | \
-xsltproc http://docbook.sourceforge.net/release/xsl/current/html/docbook.xsl -
-- 
cgit 


From be5358b01f752f636ffa40cf2052862f5c767ff3 Mon Sep 17 00:00:00 2001
From: Tim Potter <tpot@samba.org>
Date: Thu, 1 May 2003 00:31:56 +0000
Subject: Added missing documentation for 'max reported print jobs' parameter.
 (This used to be commit 21162481bcd26fc7c994bff60c2b0ad9f5fee245)

---
 .../smbdotconf/printing/maxreportedprintjobs.xml   | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)
 create mode 100644 docs/docbook/smbdotconf/printing/maxreportedprintjobs.xml

(limited to 'docs/docbook/smbdotconf')

diff --git a/docs/docbook/smbdotconf/printing/maxreportedprintjobs.xml b/docs/docbook/smbdotconf/printing/maxreportedprintjobs.xml
new file mode 100644
index 0000000000..743a5a5aed
--- /dev/null
+++ b/docs/docbook/smbdotconf/printing/maxreportedprintjobs.xml
@@ -0,0 +1,22 @@
+<samba:parameter name="max reported print jobs"
+                 context="S"
+		 print="1"
+                 xmlns:samba="http://samba.org/common">
+<listitem>
+    <para>This parameter limits the maximum number of 
+    jobs displayed in a port monitor for Samba printer queue at any given 
+    moment. If this number is exceeded, the excess jobs will not be shown.
+    A value of zero means there is no limit on the number of print
+    jobs reported.
+
+    See all <link linkend="TOTALPRINTJOBS"><parameter moreinfo="none">total
+    print jobs</parameter></link> and <link
+    linkend="MAXPRINTJOBS"><parameter moreinfo="none">max print
+    jobs</parameter></link> parameters.
+    </para>
+
+    <para>Default: <command moreinfo="none">max reported print jobs = 0</command></para>
+
+    <para>Example: <command moreinfo="none">max reported print jobs = 1000</command></para>
+</listitem>
+</samba:parameter>
-- 
cgit 


From 5c15a8d01696c2000dd3276e0bab54f2621a03cb Mon Sep 17 00:00:00 2001
From: Tim Potter <tpot@samba.org>
Date: Thu, 1 May 2003 00:43:18 +0000
Subject: Fleshed out the description of restrict anonymous parameter. (This
 used to be commit 2d150947082114f5e275a774baefc7e838ab5657)

---
 docs/docbook/smbdotconf/security/restrictanonymous.xml | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

(limited to 'docs/docbook/smbdotconf')

diff --git a/docs/docbook/smbdotconf/security/restrictanonymous.xml b/docs/docbook/smbdotconf/security/restrictanonymous.xml
index 7f78f94a99..3bd19833de 100644
--- a/docs/docbook/smbdotconf/security/restrictanonymous.xml
+++ b/docs/docbook/smbdotconf/security/restrictanonymous.xml
@@ -3,8 +3,15 @@
                  advanced="1" developer="1"
                  xmlns:samba="http://samba.org/common">
 <listitem>
-    <para>This is a integer parameter, and mirrors as much as possible the functinality the
-    <constant>RestrictAnonymous</constant> registry key does on NT/Win2k.
+    <para>The setting of this parameter determines whether user and
+    group list information is returned for an anonymous connection.
+    and mirrors the effects of the
+    <constant>HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\LSA\RestrictAnonymous</constant> registry key in Windows
+    2000 and Windows NT.  When set to 0, user and group list
+    information is returned to anyone who asks.  When set
+    to 1, only an authenticated user can retrive user and
+    group list information.  The value 2, supported by
+    Windows 2000 and higher, is not supported by Samba.
     </para>
 
     <para>Default: <command moreinfo="none">restrict anonymous = 0</command></para>
-- 
cgit 


From a9aea1449a3a311c8bf05e4c794c741910bc0459 Mon Sep 17 00:00:00 2001
From: Tim Potter <tpot@samba.org>
Date: Thu, 1 May 2003 02:00:32 +0000
Subject: Apparently we do support RA=2. (This used to be commit
 e146682b9f0cd8c8f6be6cad4b05a86ca118e973)

---
 docs/docbook/smbdotconf/security/restrictanonymous.xml | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

(limited to 'docs/docbook/smbdotconf')

diff --git a/docs/docbook/smbdotconf/security/restrictanonymous.xml b/docs/docbook/smbdotconf/security/restrictanonymous.xml
index 3bd19833de..803bc06b2b 100644
--- a/docs/docbook/smbdotconf/security/restrictanonymous.xml
+++ b/docs/docbook/smbdotconf/security/restrictanonymous.xml
@@ -10,8 +10,15 @@
     2000 and Windows NT.  When set to 0, user and group list
     information is returned to anyone who asks.  When set
     to 1, only an authenticated user can retrive user and
-    group list information.  The value 2, supported by
-    Windows 2000 and higher, is not supported by Samba.
+    group list information.  For the value 2, supported by
+    Windows 2000/XP and Samba, no anonymous connections are allowed at
+    all.  This can break third party and Microsoft
+    applications which expect to be allowed to perform
+    operations anonymously.
+
+    The security advantage of using restrict anonymous = 1 is dubious,
+    as user and group list information can be obtained using other
+    means.
     </para>
 
     <para>Default: <command moreinfo="none">restrict anonymous = 0</command></para>
-- 
cgit