]> git.ipfire.org Git - thirdparty/samba.git/commitdiff
Some random updates.
authorJelmer Vernooij <jelmer@samba.org>
Mon, 4 Jul 2005 21:36:46 +0000 (21:36 +0000)
committerGerald W. Carter <jerry@samba.org>
Wed, 23 Apr 2008 13:47:00 +0000 (08:47 -0500)
40 files changed:
docs/Makefile
docs/Samba3-HOWTO/index.xml
docs/Samba3-HOWTO/manpages.xml
docs/configure.in
docs/smbdotconf/base/bindinterfacesonly.xml
docs/smbdotconf/base/comment.xml
docs/smbdotconf/base/displaycharset.xml
docs/smbdotconf/base/path.xml
docs/smbdotconf/base/workgroup.xml
docs/smbdotconf/browse/domainmaster.xml
docs/smbdotconf/browse/lmannounce.xml
docs/smbdotconf/browse/lminterval.xml
docs/smbdotconf/browse/oslevel.xml
docs/smbdotconf/browse/preferredmaster.xml
docs/smbdotconf/domain/machinepasswordtimeout.xml
docs/smbdotconf/filename/casesensitive.xml
docs/smbdotconf/filename/defaultcase.xml
docs/smbdotconf/filename/deletevetofiles.xml
docs/smbdotconf/filename/mangledmap.xml
docs/smbdotconf/filename/manglednames.xml
docs/smbdotconf/filename/maparchive.xml
docs/smbdotconf/filename/maphidden.xml
docs/smbdotconf/filename/mapsystem.xml
docs/smbdotconf/filename/preservecase.xml
docs/smbdotconf/filename/shortpreservecase.xml
docs/smbdotconf/filename/storedosattributes.xml
docs/smbdotconf/filename/vetofiles.xml
docs/smbdotconf/filename/vetooplockfiles.xml
docs/smbdotconf/ldap/ldapadmindn.xml
docs/smbdotconf/ldap/ldapgroupsuffix.xml
docs/smbdotconf/ldap/ldapidmapsuffix.xml
docs/smbdotconf/ldap/ldappasswdsync.xml
docs/smbdotconf/ldap/ldapport.xml
docs/smbdotconf/ldap/ldapssl.xml
docs/smbdotconf/ldap/ldapsuffix.xml
docs/smbdotconf/ldap/ldapusersuffix.xml
docs/smbdotconf/locking/cscpolicy.xml
docs/smbdotconf/security/writelist.xml
docs/xslt/latex.xsl
docs/xslt/latex/sambadoc.cls

index 8704ead7187cb72820695c9a77b9f91be7b3f7b5..2d3b3e8cc6f43f09ebe27c90259b19ea183fc231 100644 (file)
@@ -151,16 +151,16 @@ $(PDFDIR)/%.pdf: %.pdf
 
        @echo >> $@
        @echo "\$$(HTMLDIR)/%: $*/%" >> $@
-       @echo " mkdir -p \$$(@D)" >> $@
-       @echo " cp \$$< \$$@" >> $@
+       @echo " @mkdir -p \$$(@D)" >> $@
+       @echo " @cp \$$< \$$@" >> $@
        @echo >> $@
        @echo "\$$(HTMLDIR)/$*/%: $*/%" >> $@
-       @echo " mkdir -p \$$(@D)" >> $@
-       @echo " cp \$$< \$$@" >> $@
+       @echo " @mkdir -p \$$(@D)" >> $@
+       @echo " @cp \$$< \$$@" >> $@
        @echo >> $@
        @echo "\$$(HTMLHELPDIR)/$*/%: $*/%" >> $@
-       @echo " mkdir -p \$$(@D)" >> $@
-       @echo " cp \$$< \$$@" >> $@
+       @echo " @mkdir -p \$$(@D)" >> $@
+       @echo " @cp \$$< \$$@" >> $@
        @echo >> $@
        @echo "$*-images-html-single: \$$(addprefix \$$(HTMLDIR)/, \$$($*-images-html))" >> $@
        @echo "$*-images-html-chunks: \$$(addprefix \$$(HTMLDIR)/$*/, \$$($*-images-html))" >> $@
@@ -187,10 +187,10 @@ $(DVIDIR)/%.dvi: %.dvi
        -$(LATEX) $< 
 
 %.eps: %.dia
-       $(DIA) -t eps-builtin -e $@ $<
+       @$(DIA) -t eps-builtin -e $@ $<
 
 %.png: %.dia
-       $(DIA) -e $@ $<
+       @$(DIA) -e $@ $<
 
 %.pdf: %.eps
        $(EPSTOPDF) $<
index 609f7b174e3f21878a52926a000cbb7836e3476b..2a477be3eca6ba402493e67ecf518ab362484f40 100644 (file)
@@ -160,18 +160,18 @@ The chapters in this part each cover specific Samba features.
        <xi:include href="TOSHARG-SecureLDAP.xml"/>
        <xi:include href="TOSHARG-Support.xml"/>
        <xi:include href="TOSHARG-DNS-DHCP-Configuration.xml"/>
+</part>
 
 <!-- Comment out the following line to include the manpages.
         *Please* do not commit with the line below enabled! -->
        <!--     <xi:include href="manpages.xml"/> -->
-       <xi:include href="manpages.xml"/>
-       <xi:include href="http://www.gnu.org/licenses/gpl.xml"/>
+<xi:include href="manpages.xml"/>
+<xi:include href="http://www.gnu.org/licenses/gpl.xml"/>
 
-       <xi:include href="TOSHARG-glossary.xml"/>
+<xi:include href="TOSHARG-glossary.xml"/>
 
-       <?latex \chaptermark{Subject index} ?>
+<?latex \chaptermark{Subject index} ?>
 
-       <index/>
-</part>
+<index/>
 
 </book>
index 12e9827c89be3c9c6346de5dc3bf24d1e7d3c162..ec2eea5e59871c21c2212a4dca462bd1fda47549 100644 (file)
@@ -1,6 +1,7 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
 <!DOCTYPE reference PUBLIC "-//Samba-Team//DTD DocBook V4.2-Based Variant V1.0//EN" "http://www.samba.org/samba/DTD/samba-doc">
-<reference id="manuals" xmlns:xi="http://www.w3.org/2003/XInclude">                                 <title>Manual pages</title>
+<appendix id="manuals" xmlns:xi="http://www.w3.org/2003/XInclude">
+       <title>Manual pages</title>
 
        <para>This appendix contains most of the manual pages from the official Samba distribution. All manual pages have been written by members of 
                <ulink url="http://samba.org/samba/team.html">the Samba Team</ulink>.</para>
@@ -26,4 +27,4 @@
        <xi:include href="../manpages-3/wbinfo.1.xml"/>
        <xi:include href="../manpages-3/winbindd.8.xml"/>
 
-</reference>
+</appendix>
index c8fbb7bc2208a6a171af5dfba65e29c80c635a58..9d336e232085417e4498ff22143cb6536ed7df27 100644 (file)
@@ -7,7 +7,7 @@ AC_ARG_WITH(samba-sources,
 LATEX_DOCUMENTCLASS_OPTIONS="letterpaper,11pt,openright,twoside"
 AC_ARG_ENABLE(prentice-hall,
 [ --enable-prentice-hall     Produce Prentice-Hall compatible output],
-[ test "$enableval" && LATEX_DOCUMENTCLASS_OPTIONS="letterpaper,10pt,openright,twoside,ph" ])
+[ test "$enableval" && LATEX_DOCUMENTCLASS_OPTIONS="letterpaper,10pt,openleft,twoside,ph" ])
 AC_SUBST(LATEX_DOCUMENTCLASS_OPTIONS)
 
 DOC_BUILD_DATE=`date '+%d-%m-%Y'`
index 67bb2302e7d53fd83a4a675f56be88e06c53f8d8..0fd302ceaa6725249133749108a3fff29fd0544e 100644 (file)
         binds to the &quot;all addresses&quot; interface (0.0.0.0) 
        on ports 137 and 138 for the purposes of reading broadcast messages. 
        If this option is not set then <command moreinfo="none">nmbd</command> will service 
-       name requests on all of these sockets. If <parameter moreinfo="none">bind interfaces
-       only</parameter> is set then <command moreinfo="none">nmbd</command> will check the 
+       name requests on all of these sockets. If <smbconfoption name="bind interfaces only"/> is set then <command moreinfo="none">nmbd</command> will check the 
        source address of any packets coming in on the broadcast sockets 
        and discard any that don't match the broadcast addresses of the 
-       interfaces in the <parameter moreinfo="none">interfaces</parameter> parameter list. 
+       interfaces in the <smbconfoption name="interfaces"/> parameter list. 
        As unicast packets are received on the other sockets it allows 
        <command moreinfo="none">nmbd</command> to refuse to serve names to machines that 
        send packets that arrive through any interfaces not listed in the
-       <parameter moreinfo="none">interfaces</parameter> list.  IP Source address spoofing
+       <smbconfoption name="interfaces"/> list.  IP Source address spoofing
        does defeat this simple check, however, so it must not be used
        seriously as a security feature for <command moreinfo="none">nmbd</command>.</para>
 
@@ -36,9 +35,9 @@
         for machines that are serving PPP or other intermittent or non-broadcast network 
        interfaces as it will not cope with non-permanent interfaces.</para>
 
-       <para>If <parameter moreinfo="none">bind interfaces only</parameter> is set then 
+<para>If <smbconfoption name="bind interfaces only"/> is set then 
        unless the network address <emphasis>127.0.0.1</emphasis> is added 
-       to the <parameter moreinfo="none">interfaces</parameter> parameter 
+       to the <smbconfoption name="interfaces"/> parameter 
         list <citerefentry><refentrytitle>smbpasswd</refentrytitle>
        <manvolnum>8</manvolnum></citerefentry> and <citerefentry><refentrytitle>swat</refentrytitle>
        <manvolnum>8</manvolnum></citerefentry> may not work as expected due 
@@ -47,9 +46,9 @@
        <para>To change a users SMB password, the <command moreinfo="none">smbpasswd</command>
        by default connects to the <emphasis>localhost - 127.0.0.1</emphasis> 
        address as an SMB client to issue the password change request. If 
-       <parameter moreinfo="none">bind interfaces only</parameter> is set then unless the 
+       <smbconfoption name="bind interfaces only"/> is set then unless the 
        network address <emphasis>127.0.0.1</emphasis> is added to the
-       <parameter moreinfo="none">interfaces</parameter> parameter list then <command moreinfo="none">
+       <smbconfoption name="interfaces"/> parameter list then <command moreinfo="none">
        smbpasswd</command> will fail to connect in it's default mode. 
        <command moreinfo="none">smbpasswd</command> can be forced to use the primary IP interface 
        of the local host by using its <citerefentry><refentrytitle>smbpasswd</refentrytitle>
index 46d3d0a6a7b3b2373ac091cee0d79247dc3bafc3..ce3b574ddf61a7e1eb285a7fa3e923fd102641cc 100644 (file)
@@ -10,8 +10,7 @@
        are available.</para>
 
        <para>If you want to set the string that is displayed next to the 
-       machine name then see the <link linkend="SERVERSTRING"><parameter moreinfo="none">
-       server string</parameter></link> parameter.</para>
+               machine name then see the <smbconfoption name="server string"/> parameter.</para>
 
 </description>
 <value type="default"><comment>No comment</comment></value>
index 8439f9d130fb7b9b11f91bfefe76b1a589531b26..ca25efee368f7867b4b3422f3413ce3e08b82d13 100644 (file)
@@ -6,7 +6,7 @@
 <description>
         <para>Specifies the charset that samba will use 
        to print messages to stdout and stderr and SWAT will use. 
-       Should generally be the same as the <command moreinfo="none">unix charset</command>.
+       Should generally be the same as the <smbconfoption name="unix charset"/>.
 </para>
 </description>
 
index 099a72d45137dcbbf307f897e20a358851e0017f..7828e6244176224283998a4f9d0bf9bc78910885 100644 (file)
@@ -22,8 +22,8 @@
        connecting from. These replacements are very useful for setting 
        up pseudo home directories for users.</para>
 
-       <para>Note that this path will be based on <link linkend="ROOTDIR">
-       <parameter moreinfo="none">root dir</parameter></link> if one was specified.</para>
+<para>Note that this path will be based on <smbconfoption name="root dir"/>
+        if one was specified.</para>
        </description>
 
        <value type="default"></value>
index c698394240d8d6284a054be8864ba444111d53c0..d62c3d5e126ee8975a88d0f1d988798f636f545c 100644 (file)
@@ -7,7 +7,7 @@
         <para>This controls what workgroup your server will 
        appear to be in when queried by clients. Note that this parameter 
        also controls the Domain name used with 
-        the <link linkend="SECURITYEQUALSDOMAIN"><command moreinfo="none">security = domain</command></link>
+       the <smbconfoption name="security">domain</smbconfoption>
                setting.</para>
 </description>
 <value type="default">WORKGROUP</value>
index 54f97caf3774a21fd01797db4d3b57a667490da6..d946ced7e6d0a58bcfc426298f3e94d33021bb95 100644 (file)
@@ -8,9 +8,9 @@
        <manvolnum>8</manvolnum></citerefentry> to enable WAN-wide browse list
        collation. Setting this option causes <command moreinfo="none">nmbd</command> to
        claim a special domain specific NetBIOS name that identifies 
-       it as a domain master browser for its given <link linkend="WORKGROUP">
-       <parameter moreinfo="none">workgroup</parameter></link>. Local master browsers 
-       in the same <parameter moreinfo="none">workgroup</parameter> on broadcast-isolated 
+       it as a domain master browser for its given 
+               <smbconfoption name="workgroup"/>. Local master browsers 
+               in the same <smbconfoption name="workgroup"/> on broadcast-isolated 
        subnets will give this <command moreinfo="none">nmbd</command> their local browse lists, 
        and then ask <citerefentry><refentrytitle>smbd</refentrytitle>
        <manvolnum>8</manvolnum></citerefentry> for a complete copy of the browse 
        instead of just the list for their broadcast-isolated subnet.</para>
 
        <para>Note that Windows NT Primary Domain Controllers expect to be 
-       able to claim this <parameter moreinfo="none">workgroup</parameter> specific special 
+               able to claim this <smbconfoption name="workgroup"/> specific special 
        NetBIOS name that identifies them as domain master browsers for 
-       that <parameter moreinfo="none">workgroup</parameter> by default (i.e. there is no 
+       that <smbconfoption name="workgroup"/> by default (i.e. there is no 
        way to prevent a Windows NT PDC from attempting to do this). This 
        means that if this parameter is set and <command moreinfo="none">nmbd</command> claims 
-       the special name for a <parameter moreinfo="none">workgroup</parameter> before a Windows 
+       the special name for a <smbconfoption name="workgroup"/> before a Windows 
        NT PDC is able to do so then cross subnet browsing will behave 
        strangely and may fail.</para>
                
-       <para>If <link linkend="DOMAINLOGONS"><command moreinfo="none">domain logons = yes</command>
-       </link>, then the default behavior is to enable the <parameter moreinfo="none">domain 
-       master</parameter> parameter.  If <parameter moreinfo="none">domain logons</parameter> is 
-       not enabled (the default setting), then neither will <parameter moreinfo="none">domain 
-       master</parameter> be enabled by default.</para>
+<para>If <smbconfoption name="domain logons">yes</smbconfoption>
+       , then the default behavior is to enable the <smbconfoption name="domain 
+               master"/> parameter.  If <smbconfoption name="domain logons"/> is 
+       not enabled (the default setting), then neither will <smbconfoption name="domain master"/> be enabled by default.</para>
 
 </description>
 <value type="default">auto</value>
index d29f0e623d5f5fa543ac1bf27b7d4e81b7dc5048..92365d8e508ed90b8e075bff5e624464a45f2399 100644 (file)
        If set to <constant>no</constant> Samba will never produce these 
        broadcasts. If set to <constant>yes</constant> Samba will produce 
        Lanman announce broadcasts at a frequency set by the parameter 
-       <parameter moreinfo="none">lm interval</parameter>. If set to <constant>auto</constant> 
+       <smbconfoption name="lm interval"/>. If set to <constant>auto</constant> 
        Samba will not send Lanman announce broadcasts by default but will 
        listen for them. If it hears such a broadcast on the wire it will 
        then start sending them at a frequency set by the parameter 
-       <parameter moreinfo="none">lm interval</parameter>.</para>
+       <smbconfoption name="lm interval"/>.</para>
 </description>
 
 <related>lm interval</related>
index abe80bc8fbb51a67b8a4a129ff4738c97a014e9e..4f3816514773acbdaa61f92bb356fba48d88695c 100644 (file)
@@ -5,11 +5,11 @@
                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 <description>
        <para>If Samba is set to produce Lanman announce 
-       broadcasts needed by OS/2 clients (see the <link linkend="LMANNOUNCE">
-       <parameter moreinfo="none">lm announce</parameter></link> parameter) then this 
+       broadcasts needed by OS/2 clients (see the 
+               <smbconfoption name="lm announce"/> parameter) then this 
        parameter defines the frequency in seconds with which they will be 
        made.  If this is set to zero then no Lanman announcements will be 
-       made despite the setting of the <parameter moreinfo="none">lm announce</parameter
+       made despite the setting of the <smbconfoption name="lm announce"/
        parameter.</para>
 </description>
 <related>lm announce</related>
index e379d5053b2cdab1091858e7a0198c5d5bff8ce4..487b1656046d77fc8c101f08830c81bfff1f3d31 100644 (file)
@@ -8,8 +8,7 @@
        advertises itself as for browse elections. The value of this 
        parameter determines whether <citerefentry><refentrytitle>nmbd</refentrytitle>
        <manvolnum>8</manvolnum></citerefentry> 
-       has a chance of becoming a local master browser for the <parameter moreinfo="none">
-       WORKGROUP</parameter> in the local broadcast area.</para>
+has a chance of becoming a local master browser for the <smbconfoption name="workgroup"/> in the local broadcast area.</para>
                
        <para><emphasis>Note :</emphasis>By default, Samba will win 
        a local master browsing election over all Microsoft operating 
index 8a6d8706c334f8569a1c42f63f7a93cfb96c717d..009aac3d3dd4f2cfaad19141590e78182df6d1fc 100644 (file)
@@ -13,8 +13,8 @@
        <para>If this is set to <constant>yes</constant>, on startup, <command moreinfo="none">nmbd</command> 
        will force an election, and it will have a slight advantage in 
        winning the election.  It is recommended that this parameter is 
-       used in conjunction with <command moreinfo="none"><link linkend="DOMAINMASTER">
-       <parameter moreinfo="none">domain master</parameter></link> = yes</command>, so 
+       used in conjunction with 
+                       <smbconfoption name="domain master">yes</smbconfoption>, so 
        that <command moreinfo="none">nmbd</command> can guarantee becoming a domain master.</para>
                
        <para>Use this option with caution, because if there are several 
index 3a2b23d2d373bb178d9a7d9fdab7dc06051484d9..790eaf97b9a6336ffc537711cffc0af18240889d 100644 (file)
@@ -5,7 +5,7 @@
                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
                                 <description>
        <para>If a Samba server is a member of a Windows 
-       NT Domain (see the <link linkend="SECURITYEQUALSDOMAIN">security = domain</link>
+               NT Domain (see the <smbconfoption name="security">domain</smbconfoption>
        parameter) then periodically a running smbd
         process will try and change the MACHINE ACCOUNT 
        PASSWORD stored in the TDB called <filename moreinfo="none">private/secrets.tdb
@@ -14,8 +14,7 @@
        seconds), the same as a Windows NT Domain member server.</para>
 
        <para>See also <citerefentry><refentrytitle>smbpasswd</refentrytitle>
-       <manvolnum>8</manvolnum></citerefentry>, and the <link linkend="SECURITYEQUALSDOMAIN">
-       security = domain</link> parameter.</para>
+                       <manvolnum>8</manvolnum></citerefentry>, and the <smbconfoption name="security">domain</smbconfoption> parameter.</para>
 
 </description>
 <value type="default">604800</value>
index bace4b360fc102ea1a726cabf99ee36812db18aa..7765adced2d51b2c13ff1cacb0fed87477dffcae 100644 (file)
@@ -4,7 +4,7 @@
                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 <synonym>casesignames</synonym>
 <description>
-       <para>See the discussion in the section <link linkend="NAMEMANGLINGSECT">NAME MANGLING</link>.</para>
+       <para>See the discussion in the section <smbconfoption name="name mangling"/>.</para>
 </description>
 <value type="default">no</value>
 </samba:parameter>
index 082a26cff97f6f0ea0ac3b226f1c24e8b2f37049..ac5f589d3a144e414c7f5c23b83d53ccef9b1383 100644 (file)
@@ -2,9 +2,8 @@
        context="S"
        type="string" xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 <description>
-       <para>See the section on <link linkend="NAMEMANGLINGSECT">
-       NAME MANGLING</link>. Also note the <link linkend="SHORTPRESERVECASE">
-       <parameter moreinfo="none">short preserve case</parameter></link> parameter.</para>
+       <para>See the section on <smbconfoption name="name mangling"/>
+               . Also note the <smbconfoption name="short preserve case"/> parameter.</para>
 </description>
 <value type="default">lower</value>
 </samba:parameter>
index a8ccced47d81521c8f8427a1b81878613d5f899e..b8809bacd7cb404e26114be4e47a11d8687d576f 100644 (file)
@@ -5,7 +5,7 @@
 <description>
        <para>This option is used when Samba is attempting to 
        delete a directory that contains one or more vetoed directories 
-       (see the <link linkend="VETOFILES"><parameter moreinfo="none">veto files</parameter></link>
+       (see the <smbconfoption name="veto files"/>
        option).  If this option is set to <constant>no</constant> (the default) then if a vetoed 
        directory contains any non-vetoed files or directories then the 
        directory delete will fail. This is usually what you want.</para>
@@ -17,7 +17,7 @@
        directories you might normally veto DOS/Windows users from seeing 
        (e.g. <filename moreinfo="none">.AppleDouble</filename>)</para>
 
-       <para>Setting <command moreinfo="none">delete veto files = yes</command> allows these 
+<para>Setting <smbconfoption name="delete veto files">yes</smbconfoption> allows these 
        directories to be  transparently deleted when the parent directory 
        is deleted (so long as the user has permissions to do so).</para>
 </description>
index b199a299de58800fd7277d3bc07d0b651538d179..cbcec9b1df1c2a400793520f46a143c77fc99de4 100644 (file)
@@ -14,7 +14,7 @@
        <para>So to map <filename moreinfo="none">html</filename> to <filename moreinfo="none">htm</filename> 
        you would use:</para>
                
-       <para><command moreinfo="none">mangled map = (*.html *.htm)</command></para>
+<para><smbconfoption name="mangled map">(*.html *.htm)</smbconfoption>.</para>
 
        <para>One very useful case is to remove the annoying <filename moreinfo="none">;1
        </filename> off the ends of filenames on some CDROMs (only visible 
index 9906c595bc6f07eb083e7f2f57d55bfa571c5b9b..64bc4a9412c47c277a9fb0b131e33aa971677329 100644 (file)
@@ -7,7 +7,7 @@
        should be mapped to DOS-compatible names (&quot;mangled&quot;) and made visible, 
        or whether non-DOS names should simply be ignored.</para>
 
-       <para>See the section on <link linkend="NAMEMANGLINGSECT">NAME MANGLING</link> for 
+<para>See the section on <smbconfoption name="name mangling"/> for 
        details on how to control the mangling process.</para>
 
        <para>If mangling is used then the mangling algorithm is as follows:</para>
@@ -29,8 +29,8 @@
                        characters.</para>
 
                        <para>Note that the character to use may be specified using 
-                       the <link linkend="MANGLINGCHAR"><parameter moreinfo="none">mangling char</parameter>
-                       </link> option, if you don't like '~'.</para>
+                               the <smbconfoption name="mangling char"/>
+                       option, if you don't like '~'.</para>
                </listitem>
 
                <listitem>
index 0a6504a3c911e519b7379e8f7d2a52dd37ba3667..1110ec943be42e29916e4c1095c628fec143fc53 100644 (file)
        any file it touches from becoming executable under UNIX.  This can 
        be quite annoying for shared source code, documents, etc...</para>
 
-       <para>Note that this requires the <parameter moreinfo="none">create mask</parameter>
+<para>Note that this requires the <smbconfoption name="create mask"/>
        parameter to be set such that owner execute bit is not masked out 
-       (i.e. it must include 100). See the parameter <link linkend="CREATEMASK">
-       <parameter moreinfo="none">create mask</parameter></link> for details.</para>
+       (i.e. it must include 100). See the parameter <smbconfoption name="create mask"/> for details.</para>
 </description>
 
 <value type="default">yes</value>
index f3a6abd57f2520dfddcde227c38cf182b13f7700..da40f7ff3eb6bc0935e92f0c9953f3185e534baf 100644 (file)
@@ -6,10 +6,9 @@
        <para>This controls whether DOS style hidden files 
        should be mapped to the UNIX world execute bit.</para>
 
-       <para>Note that this requires the <parameter moreinfo="none">create mask</parameter
+<para>Note that this requires the <smbconfoption name="create mask"/
        to be set such that the world execute bit is not masked out (i.e. 
-       it must include 001). See the parameter <link linkend="CREATEMASK">
-       <parameter moreinfo="none">create mask</parameter></link> for details.</para>
+       it must include 001). See the parameter <smbconfoption name="create mask"/> for details.</para>
 
 </description>
 <value type="boolean">no</value>
index cf8226dd0971aae74470c483d8fe8ecc5e6ba38f..35b7dc7cfec074fa8d2ae85f20f7625aee863f9b 100644 (file)
@@ -6,10 +6,10 @@
        <para>This controls whether DOS style system files 
        should be mapped to the UNIX group execute bit.</para>
 
-       <para>Note that this requires the <parameter moreinfo="none">create mask</parameter> 
+<para>Note that this requires the <smbconfoption name="create mask"/>
        to be set such that the group execute bit is not masked out (i.e. 
-       it must include 010). See the parameter <link linkend="CREATEMASK">
-       <parameter moreinfo="none">create mask</parameter></link> for details.</para>
+       it must include 010). See the parameter <smbconfoption name="create mask"/>
+        for details.</para>
        </description>
        <value type="default">no</value>
 </samba:parameter>
index 6346c31463fedd5de2f0c8cab6ee432bb578127f..e84cb56461f40796bf445ea0abd1e037419acf83 100644 (file)
@@ -5,8 +5,7 @@
 <description>
        <para> This controls if new filenames are created
        with the case that the client passes, or if they are forced to 
-       be the <link linkend="DEFAULTCASE"><parameter moreinfo="none">default case
-       </parameter></link>.</para>
+       be the <smbconfoption name="default case"/>.</para>
        <para>See the section on <link linkend="NAMEMANGLINGSECT">NAME MANGLING</link> for a fuller discussion.</para>
 </description>
 
index 8742b60830706bbaad773ca6babe4558ad8cf07d..5a164c3d48b5ba9a91baf6ed634a660322922e79 100644 (file)
@@ -6,9 +6,9 @@
        <para>This boolean parameter controls if new files 
        which conform to 8.3 syntax, that is all in upper case and of 
        suitable length, are created upper case, or if they are forced 
-       to be the <link linkend="DEFAULTCASE"><parameter moreinfo="none">default case
-       </parameter></link>. This  option can be use with <link linkend="PRESERVECASE"><command moreinfo="none">preserve case = yes</command>
-       </link> to permit long filenames to retain their case, while short 
+       to be the <smbconfoption name="default case"/>
+       . This  option can be use with <smbconfoption name="preserve case">yes</smbconfoption>
+        to permit long filenames to retain their case, while short 
        names are lowered. </para>
                
        <para>See the section on <link linkend="NAMEMANGLINGSECT">NAME MANGLING</link>.</para>
index 56e5a0c17582d0e4674c88eb27e5482a0f639330..bedf185c2fdb8c3a315ce736b796e811c178ffe5 100644 (file)
@@ -5,9 +5,9 @@
 <description>
        <para>If this parameter is set Samba no longer attempts to
        map DOS attributes like SYSTEM, HIDDEN, ARCHIVE or READ-ONLY
-       to UNIX permission bits (such as the <link linkend="MAPHIDDEN"><parameter moreinfo="none">map hidden</parameter></link>. Instead, DOS attributes will be stored onto an extended
+       to UNIX permission bits (such as the <smbconfoption name="map hidden"/>. Instead, DOS attributes will be stored onto an extended
        attribute in the UNIX filesystem, associated with the file or directory.
-       For this to operate correctly, the parameters <link linkend="MAPHIDDEN"><parameter moreinfo="none">map hidden</parameter></link>, <link linkend="MAPSYSTEM"><parameter moreinfo="none">map system</parameter></link>, <link linkend="MAPARCHIVE"><parameter moreinfo="none">map archive</parameter></link> must be set to off.
+       For this to operate correctly, the parameters <smbconfoption name="map hidden"/>, <smbconfoption name="map system"/>, <smbconfoption name="map archive"/> must be set to off.
        This parameter writes the DOS attributes as a string into the
        extended attribute named "user.DOSATTRIB". This extended attribute
        is explicitly hidden from smbd clients requesting an EA list.
index b5a60053f462468ae72ea07e73feda41fb0576bd..9115da6f7c69b5f3caba0f733b6e1d15819839e8 100644 (file)
@@ -13,7 +13,7 @@
        must <emphasis>not</emphasis> include the  unix directory 
        separator '/'.</para>
 
-       <para>Note that the <parameter moreinfo="none">case sensitive</parameter> option 
+<para>Note that the <smbconfoption name="case sensitive"/> option 
        is applicable in vetoing files.</para>
                
        <para>One feature of the veto files parameter that it
@@ -21,7 +21,7 @@
        trying to delete a directory. If a directory that is
        to be deleted contains nothing but veto files this
        deletion will <emphasis>fail</emphasis> unless you also set
-       the <parameter moreinfo="none">delete veto files</parameter> parameter to
+       the <smbconfoption name="delete veto files"/> parameter to
        <parameter moreinfo="none">yes</parameter>.</para>
 
        <para>Setting this parameter will affect the performance 
index 6deb2d20b0cb2991d9fb97e4a12e7affd544aeb6..a8b27977964c8fbc94a7ec69a56b9b27aae0edcb 100644 (file)
@@ -3,12 +3,12 @@
                                 type="string"
                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
  <description>
-       <para>This parameter is only valid when the <link linkend="OPLOCKS">
-       <parameter moreinfo="none">oplocks</parameter></link>
+       <para>This parameter is only valid when the 
+                       <smbconfoption name="oplocks"/>
        parameter is turned on for a share. It allows the Samba administrator
        to selectively turn off the granting of oplocks on selected files that
        match a wildcarded list, similar to the wildcarded list used in the
-       <link linkend="VETOFILES"><parameter moreinfo="none">veto files</parameter></link
+       <smbconfoption name="veto files"/
        parameter.</para>
 
 
index 4e6c30c141d8ac24f62465b5c50cc899999a74e5..5f8805ad144eef18e73c5227c4933b0c419e5903 100644 (file)
@@ -4,11 +4,10 @@
                                 type="string"
                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
                                 <description>
-       <para> The <parameter moreinfo="none">ldap admin dn</parameter>
+                                        <para> The <smbconfoption name="ldap admin dn"/>
        defines the Distinguished  Name (DN) name used by Samba to
        contact the ldap server when retreiving  user account
-       information. The <parameter moreinfo="none">ldap admin
-       dn</parameter> is used in conjunction with the admin dn password
+       information. The <smbconfoption name="ldap admin dn"/> is used in conjunction with the admin dn password
        stored in the <filename moreinfo="none">private/secrets.tdb</filename> file.
        See the <citerefentry><refentrytitle>smbpasswd</refentrytitle>
        <manvolnum>8</manvolnum></citerefentry> man page for more
index 00d6fba7a09c9bd2052324e975f128cf0ec9d32c..ffbebe2f5ca44aae620145a0db810e46f5f0c8de 100644 (file)
@@ -6,7 +6,7 @@
 <description>
        <para>This parameters specifies the suffix that is 
        used for groups when these are added to the LDAP directory.
-       If this parameter is unset, the value of <parameter>ldap suffix</parameter> will be used instead.</para>
+       If this parameter is unset, the value of <smbconfoption name="ldap suffix"/> will be used instead.</para>
 
 </description>
 <value type="default"></value>
index 1557175dd68aee0c19a3f44afbfc56695d6cf497..81fc98d8b988f8d2f1c5e4e883efa00f372e0e84 100644 (file)
@@ -6,7 +6,7 @@
 <description>
        <para>This parameters specifies the suffix that is 
        used when storing idmap mappings. If this parameter 
-       is unset, the value of <parameter>ldap suffix</parameter>
+       is unset, the value of <smbconfoption name="ldap suffix"/>
        will be used instead.</para>
 </description>
 <value type="default"></value>
index f215da5bffd3a4d0dd77a1a4438c6beec091db3d..3a6b45654fb3fbd811d6e2de937e6bbe9330cf58 100644 (file)
@@ -11,8 +11,7 @@
        change via SAMBA.  
        </para>
 
-       <para>The <parameter moreinfo="none">ldap passwd
-       sync</parameter> can be set to one of three values: </para>
+       <para>The <smbconfoption name="ldap passwd sync"/> can be set to one of three values: </para>
        
        <itemizedlist>
                <listitem>
index 141382a6408bd071a7d3187d18714e989bf9351b..8895c15c7f758ae9ab9cb867e9fafcff5e505141 100644 (file)
@@ -8,7 +8,7 @@
        at compile time.</para>
 
        <para>This option is used to control the tcp port number used to contact
-       the <link linkend="LDAPSERVER"><parameter moreinfo="none">ldap server</parameter></link>.
+               the <smbconfoption name="ldap server"/>.
        The default is to use the stand LDAPS port 636.</para>
 </description>
 <related>ldap ssl</related>
index bd2f45fe3f1dc3e63de311348b4c64eb1ebccd2d..3c276b87e37d85842e4218c1efc4dbeb1f7c52d8 100644 (file)
@@ -11,7 +11,7 @@
        <command moreinfo="none">--with-ssl</command> option to the <filename moreinfo="none">configure</filename> 
        script.</para>
                
-       <para>The <parameter moreinfo="none">ldap ssl</parameter> can be set to one of three values:</para>     
+<para>The <smbconfoption name="ldap ssl"/> can be set to one of three values:</para>   
        <itemizedlist>
                <listitem>
                        <para><parameter moreinfo="none">Off</parameter> = Never 
@@ -30,8 +30,7 @@
                        moreinfo="none">ldap server</parameter>. Only available when the 
                        backwards-compatiblity <command 
                        moreinfo="none">--with-ldapsam</command> option is specified
-                       to configure. See <link linkend="PASSDBBACKEND"><parameter 
-                       moreinfo="none">passdb backend</parameter></link></para>
+               to configure. See <smbconfoption name="passdb backend"/></para>
                </listitem>
        </itemizedlist>         
 </description>
index 0bbb1c23e9b0007dd0df12cb810238de296157d7..233c61040c62e1674fb775d6d79177fb5f4bced9 100644 (file)
@@ -5,9 +5,8 @@
                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 <description>
        <para>Specifies where user and machine accounts are added to the
-       tree. Can be overriden by <command moreinfo="none">ldap user
-       suffix</command> and <command moreinfo="none">ldap machine
-       suffix</command>. It also used as the base dn for all ldap
+               tree. Can be overriden by <smbconfoption name="ldap user suffix"/> and 
+               <smbconfoption name="ldap machine suffix"/>. It also used as the base dn for all ldap
 searches. </para>
 </description>
 <value type="default"></value>
index 133b6db70798e6e7b1c8e13605593c5ad19e9b64..d860fba0da7dcdb8712403afec3220695c897981 100644 (file)
@@ -5,7 +5,7 @@
                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
 <description>
        <para>This parameter specifies where users are added to the tree. 
-       If this parameter is not specified, the value from <command>ldap suffix</command>.</para>
+               If this parameter is not specified, the value from <smbconfoption name="ldap suffix"/>.</para>
 
 </description>
 <value type="default"/>
index 9886a1e8c0d95455391f74bd6075e4b88dfbdc31..5dd76569fa87d3033cbaee9a7d36a5598983c6c1 100644 (file)
@@ -11,8 +11,7 @@
        <para>These values correspond to those used on Windows servers.</para>
 
        <para>For example, shares containing roaming profiles can have
-       offline caching disabled using <command 
-       moreinfo="none">csc policy = disable</command>.</para>
+               offline caching disabled using <smbconfoption name="csc policy">disable</smbconfoption>.</para>
 </description>
 <value type="default">manual</value>
 <value type="example">programs</value>
index 5951e7408f653b2cf81e7e0abcb57f85af18b541..3476b311bf535898c0ade6521e68f047ef9fc0e2 100644 (file)
@@ -5,16 +5,14 @@
 <description>
     <para>This is a list of users that are given read-write 
     access to a service. If the connecting user is in this list then 
-    they will be given write access, no matter what the <link linkend="READONLY">
-    <parameter moreinfo="none">read only</parameter></link>
+       they will be given write access, no matter what the <smbconfoption name="read only"/>
     option is set to. The list can include group names using the 
     @group syntax.</para>
 
     <para>Note that if a user is in both the read list and the 
     write list then they will be given write access.</para>
 
-    <para>This parameter will not work with the <link linkend="SECURITY">
-    <parameter moreinfo="none">security = share</parameter></link> in
+<para>This parameter will not work with the <smbconfoption name="security">share</smbconfoption> in
     Samba 3.0.  This is by design.</para>
 
 </description>
index b3434d876ac3f40c9dc135417e04cd83e178b1de..f8045db74c4b98ab6a1debc6e015e889af65f137 100644 (file)
 <xsl:template match="related"><xsl:apply-templates/></xsl:template>
 
 <xsl:template match="//samba:parameterlist">
+       <xsl:text>\begin{description}&#10;</xsl:text>
        <xsl:apply-templates>
-               <xsl:sort select="varlistentry/term/anchor"/>
+               <xsl:sort select="samba:parameter/@name"/>
        </xsl:apply-templates>
+       <xsl:text>\end{description}&#10;</xsl:text>
 </xsl:template>
 
 <xsl:template match="value/comment">
        <xsl:apply-templates/>
 </xsl:template>
 
+<xsl:template match="/">
+       <xsl:apply-templates/>
+</xsl:template>
+
 <xsl:template match="//samba:parameter">
-       <xsl:text>\subsubsection{</xsl:text><xsl:value-of select="@name"/><xsl:text>}&#10;</xsl:text>
+       <xsl:text>\item[{</xsl:text><xsl:value-of select="@name"/><xsl:text>}]&#10;</xsl:text>
        <xsl:text>\index{</xsl:text><xsl:value-of select="@name"/><xsl:text>|it}&#10;</xsl:text>
 
        <xsl:for-each select="synonym">
-       <xsl:text>\subsubsection{</xsl:text><xsl:value-of select="."/><xsl:text>}&#10;</xsl:text>
+       <xsl:text>\item[{</xsl:text><xsl:value-of select="."/><xsl:text>}]&#10;</xsl:text>
        <xsl:text>\index{</xsl:text><xsl:value-of select="."/><xsl:text>|it}&#10;</xsl:text>
        <xsl:text>This parameter is a synonym for \smbconfoption{</xsl:text><xsl:value-of select="../@name"/><xsl:text>}.</xsl:text>
        </xsl:for-each>
index 5828ccce40c2779f6b588f24f31fd6118248f97b..34b2d286e163743d1eb95e5b18c62904b1bba8b7 100644 (file)
@@ -38,7 +38,7 @@
        \RequirePackage{geometry}
        \geometry{
        twoside,
-       openright,
+       openleft,
        papersize={7in,9.25in},
        lmargin=.75in,
        rmargin=.75in,
@@ -321,7 +321,8 @@ page \thepage \space undefined}}%
        backgroundcolor=\color[gray]{0.93},
        frame=single,
        frameround=tttt,
-       prebreak={\space\linebreaksign}
+       prebreak={\space\linebreaksign},
+       basicstyle=\small
 }
 
 \newcommand{\smbconfsection}[1]{\emph{#1}}