Convert another group of options in Misc section
authorAlexander Bokovoy <ab@samba.org>
Tue, 15 Apr 2003 07:47:02 +0000 (07:47 +0000)
committerAlexander Bokovoy <ab@samba.org>
Tue, 15 Apr 2003 07:47:02 +0000 (07:47 +0000)
13 files changed:
docs/docbook/smbdotconf/misc/copy.xml
docs/docbook/smbdotconf/misc/default.xml
docs/docbook/smbdotconf/misc/dfreecommand.xml
docs/docbook/smbdotconf/misc/exec.xml
docs/docbook/smbdotconf/misc/homedirmap.xml
docs/docbook/smbdotconf/misc/include.xml
docs/docbook/smbdotconf/misc/messagecommand.xml
docs/docbook/smbdotconf/misc/nishomedir.xml
docs/docbook/smbdotconf/misc/preexec.xml
docs/docbook/smbdotconf/misc/remoteannounce.xml
docs/docbook/smbdotconf/misc/remotebrowsesync.xml
docs/docbook/smbdotconf/misc/socketaddress.xml
docs/docbook/smbdotconf/misc/timeoffset.xml

index a7945af8ae10063a72d3022fc30004c3e58725e3..c3152956b045a773063b0a6c65dcb09c2d2b8883 100644 (file)
@@ -1,15 +1,20 @@
-<samba:parameter xmlns:samba="http://samba.org/common">
-               <term><anchor id="COPY"/>copy (S)</term>
-               <listitem><para>This parameter allows you to &quot;clone&quot; service 
-               entries. The specified service is simply duplicated under the 
-               current service's name. Any parameters specified in the current 
-               section will override those in the section being copied.</para>
+<samba:parameter name="copy"
+                context="S"
+                hide="1"
+                xmlns:samba="http://samba.org/common">
+<listitem>
+       <para>This parameter allows you to &quot;clone&quot; service 
+       entries. The specified service is simply duplicated under the 
+       current service's name. Any parameters specified in the current 
+       section will override those in the section being copied.</para>
 
-               <para>This feature lets you set up a 'template' service and 
-               create similar services easily. Note that the service being 
-               copied must occur earlier in the configuration file than the 
-               service doing the copying.</para>
+       <para>This feature lets you set up a 'template' service and 
+       create similar services easily. Note that the service being 
+       copied must occur earlier in the configuration file than the 
+       service doing the copying.</para>
 
-               <para>Default: <emphasis>no value</emphasis></para>
-               <para>Example: <command moreinfo="none">copy = otherservice</command></para></listitem>
-               </samba:parameter>
+       <para>Default: <emphasis>no value</emphasis></para>
+
+       <para>Example: <command moreinfo="none">copy = otherservice</command></para>
+</listitem>
+</samba:parameter>
index c396d1947b6197b48561e9a956b1df05554dd7ce..7afaba640ba8500811d9add13b4cf654e806b284 100644 (file)
@@ -1,5 +1,9 @@
-<samba:parameter xmlns:samba="http://samba.org/common">
-               <term><anchor id="DEFAULT"/>default (G)</term>
-               <listitem><para>A synonym for <link linkend="DEFAULTSERVICE"><parameter moreinfo="none">
-               default service</parameter></link>.</para></listitem>
-               </samba:parameter>
+<samba:parameter name="default service"
+                context="G"
+                developer="1"
+                xmlns:samba="http://samba.org/common">
+<listitem>
+       <para>A synonym for <link linkend="DEFAULTSERVICE"><parameter moreinfo="none">
+                               default service</parameter></link>.</para>
+</listitem>
+</samba:parameter>
index c71ec8e00bd66459c33a405eb7c9c6b31cc21ff7..1e839a5242e6421b811de7979eb555e86b054184 100644 (file)
@@ -1,50 +1,52 @@
-<samba:parameter xmlns:samba="http://samba.org/common">
-               <term><anchor id="DFREECOMMAND"/>dfree command (G)</term>
-               <listitem><para>The <parameter moreinfo="none">dfree command</parameter> setting should 
-               only be used on systems where a problem occurs with the internal 
-               disk space calculations. This has been known to happen with Ultrix, 
-               but may occur with other operating systems. The symptom that was 
-               seen was an error of &quot;Abort Retry Ignore&quot; at the end of each 
-               directory listing.</para>
+<samba:parameter name="dfree command"
+                context="G"
+                advanced="1" developer="1"
+                xmlns:samba="http://samba.org/common">
+<listitem>
+
+       <para>The <parameter moreinfo="none">dfree command</parameter> setting
+       should only be used on systems where a problem occurs with the
+       internal disk space calculations. This has been known to happen
+       with Ultrix, but may occur with other operating systems. The
+       symptom that was seen was an error of &quot;Abort Retry
+       Ignore&quot; at the end of each directory listing.</para>
                
-               <para>This setting allows the replacement of the internal routines to
-               calculate the total disk space and amount available with an external
-               routine. The example below gives a possible script that might fulfill
-               this function.</para>
+       <para>This setting allows the replacement of the internal routines to
+       calculate the total disk space and amount available with an external
+       routine. The example below gives a possible script that might fulfill
+       this function.</para>
 
-               <para>The external program will be passed a single parameter indicating 
-               a directory in the filesystem being queried. This will typically consist
-               of the string <filename moreinfo="none">./</filename>. The script should return two 
-               integers in ASCII. The first should be the total disk space in blocks, 
-               and the second should be the number of available blocks. An optional 
-               third return value can give the block size in bytes. The default 
-               blocksize is 1024 bytes.</para>
+       <para>The external program will be passed a single parameter indicating 
+       a directory in the filesystem being queried. This will typically consist
+       of the string <filename moreinfo="none">./</filename>. The script should return two 
+       integers in ASCII. The first should be the total disk space in blocks, 
+       and the second should be the number of available blocks. An optional 
+       third return value can give the block size in bytes. The default 
+       blocksize is 1024 bytes.</para>
 
-               <para>Note: Your script should <emphasis>NOT</emphasis> be setuid or 
-               setgid and should be owned by (and writeable only by) root!</para>
+       <para>Note: Your script should <emphasis>NOT</emphasis> be setuid or 
+       setgid and should be owned by (and writeable only by) root!</para>
 
-               <para>Default: <emphasis>By default internal routines for 
-               determining the disk capacity and remaining space will be used.
-               </emphasis></para>
+       <para>Default: <emphasis>By default internal routines for 
+       determining the disk capacity and remaining space will be used.
+       </emphasis></para>
 
-               <para>Example: <command moreinfo="none">dfree command = /usr/local/samba/bin/dfree
-               </command></para>
+       <para>Example: <command moreinfo="none">dfree command = /usr/local/samba/bin/dfree</command></para>
 
-               <para>Where the script dfree (which must be made executable) could be:</para>
+       <para>Where the script dfree (which must be made executable) could be:</para>
 
 <para><programlisting format="linespecific"> 
 #!/bin/sh
 df $1 | tail -1 | awk '{print $2&quot; &quot;$4}'
 </programlisting></para>
 
-               <para>or perhaps (on Sys V based systems):</para>
+       <para>or perhaps (on Sys V based systems):</para>
 
 <para><programlisting format="linespecific"> 
 #!/bin/sh
 /usr/bin/df -k $1 | tail -1 | awk '{print $3&quot; &quot;$5}'
 </programlisting></para>
                
-               <para>Note that you may have to replace the command names 
-               with full path names on some systems.</para>
-               </listitem>
-               </samba:parameter>
+       <para>Note that you may have to replace the command names with full path names on some systems.</para>
+</listitem>
+</samba:parameter>
index 34963c90b21f01a61d2d7a4e5e8a0fbbfd221305..0d44d81bffce6903496b8761782735c8e90db038 100644 (file)
@@ -1,5 +1,9 @@
-<samba:parameter xmlns:samba="http://samba.org/common">
-               <term><anchor id="EXEC"/>exec (S)</term>
-               <listitem><para>This is a synonym for <link linkend="PREEXEC">
-               <parameter moreinfo="none">preexec</parameter></link>.</para></listitem>
-               </samba:parameter>
+<samba:parameter name="exec"
+                context="S"
+                advanced="1" developer="1"
+                xmlns:samba="http://samba.org/common">
+<listitem>
+       <para>This is a synonym for <link linkend="PREEXEC">
+       <parameter moreinfo="none">preexec</parameter></link>.</para>
+</listitem>
+</samba:parameter>
index 41e6ca5ea17f4f6d238b27bf182cfe2aa2c04935..d4f09c7f50c25ba5727e796415c78acb15e964ad 100644 (file)
@@ -1,28 +1,32 @@
-<samba:parameter xmlns:samba="http://samba.org/common">
-               <term><anchor id="HOMEDIRMAP"/>homedir map (G)</term>
-               <listitem><para>If<link linkend="NISHOMEDIR"><parameter moreinfo="none">nis homedir
-               </parameter></link> is <constant>yes</constant>, and <citerefentry><refentrytitle>smbd</refentrytitle>
-               <manvolnum>8</manvolnum></citerefentry> is also acting 
-               as a Win95/98 <parameter moreinfo="none">logon server</parameter> then this parameter 
-               specifies the NIS (or YP) map from which the server for the user's 
-               home directory should be extracted.  At present, only the Sun 
-               auto.home map format is understood. The form of the map is:</para>
+<samba:parameter name="homedir map"
+                context="G"
+                advanced="1" developer="1"
+                xmlns:samba="http://samba.org/common">
+<listitem>
+       <para>If<link linkend="NISHOMEDIR"><parameter moreinfo="none">nis homedir
+       </parameter></link> is <constant>yes</constant>, and <citerefentry><refentrytitle>smbd</refentrytitle>
+       <manvolnum>8</manvolnum></citerefentry> is also acting 
+       as a Win95/98 <parameter moreinfo="none">logon server</parameter> then this parameter 
+       specifies the NIS (or YP) map from which the server for the user's 
+       home directory should be extracted.  At present, only the Sun 
+       auto.home map format is understood. The form of the map is:</para>
 
-               <para><command moreinfo="none">username server:/some/file/system</command></para>
+       <para><command moreinfo="none">username server:/some/file/system</command></para>
 
-               <para>and the program will extract the servername from before 
-               the first ':'.  There should probably be a better parsing system 
-               that copes with different map formats and also Amd (another 
-               automounter) maps.</para>
+       <para>and the program will extract the servername from before 
+       the first ':'.  There should probably be a better parsing system 
+       that copes with different map formats and also Amd (another 
+       automounter) maps.</para>
                
-               <note><para>A working NIS client is required on 
-                               the system for this option to work.</para></note>
+       <note><para>A working NIS client is required on 
+       the system for this option to work.</para></note>
 
-               <para>See also <link linkend="NISHOMEDIR"><parameter moreinfo="none">nis homedir</parameter>
-               </link>, <link linkend="DOMAINLOGONS"><parameter moreinfo="none">domain logons</parameter>
-               </link>.</para>
+       <para>See also <link linkend="NISHOMEDIR"><parameter moreinfo="none">nis homedir</parameter>
+       </link>, <link linkend="DOMAINLOGONS"><parameter moreinfo="none">domain logons</parameter>
+       </link>.</para>
 
-               <para>Default: <command moreinfo="none">homedir map = &lt;empty string&gt;</command></para>
-               <para>Example: <command moreinfo="none">homedir map = amd.homedir</command></para>
-               </listitem>
-               </samba:parameter>
+       <para>Default: <command moreinfo="none">homedir map = &lt;empty string&gt;</command></para>
+
+       <para>Example: <command moreinfo="none">homedir map = amd.homedir</command></para>
+</listitem>
+</samba:parameter>
index 81230d43574caed69b1602c5f1a12f3309cc07e9..dcc32968e720ecdaedf9be82d272a8dd0dd658c1 100644 (file)
@@ -1,14 +1,18 @@
-<samba:parameter xmlns:samba="http://samba.org/common">
-               <term><anchor id="INCLUDE"/>include (G)</term>
-               <listitem><para>This allows you to include one config file 
-               inside another.  The file is included literally, as though typed 
-               in place.</para>
+<samba:parameter name="include"
+                context="G"
+                hide="1"
+                xmlns:samba="http://samba.org/common">
+<listitem>
+       <para>This allows you to include one config file 
+       inside another.  The file is included literally, as though typed 
+       in place.</para>
 
-               <para>It takes the standard substitutions, except <parameter moreinfo="none">%u
-               </parameter>, <parameter moreinfo="none">%P</parameter> and <parameter moreinfo="none">%S</parameter>.
-               </para>
+       <para>It takes the standard substitutions, except <parameter moreinfo="none">%u
+       </parameter>, <parameter moreinfo="none">%P</parameter> and <parameter moreinfo="none">%S</parameter>.
+       </para>
                
-               <para>Default: <emphasis>no file included</emphasis></para>
-               <para>Example: <command moreinfo="none">include = /usr/local/samba/lib/admin_smb.conf
-               </command></para></listitem>
-               </samba:parameter>
+       <para>Default: <emphasis>no file included</emphasis></para>
+
+       <para>Example: <command moreinfo="none">include = /usr/local/samba/lib/admin_smb.conf</command></para>
+</listitem>
+</samba:parameter>
index 199fab56106ad8b45b0e17d5be6c79cd05425066..6df2a02bb797ea3f96068964916cae3983d40b6f 100644 (file)
@@ -1,65 +1,73 @@
-<samba:parameter xmlns:samba="http://samba.org/common">
-               <term><anchor id="MESSAGECOMMAND"/>message command (G)</term>
-               <listitem><para>This specifies what command to run when the 
-               server receives a WinPopup style message.</para>
-
-               <para>This would normally be a command that would 
-               deliver the message somehow. How this is to be done is 
-               up to your imagination.</para>
-
-               <para>An example is:</para>
-
-               <para><command moreinfo="none">message command = csh -c 'xedit %s;rm %s' &amp;</command>
-               </para>
-
-               <para>This delivers the message using <command moreinfo="none">xedit</command>, then 
-               removes it afterwards. <emphasis>NOTE THAT IT IS VERY IMPORTANT 
-               THAT THIS COMMAND RETURN IMMEDIATELY</emphasis>. That's why I 
-               have the '&amp;' on the end. If it doesn't return immediately then 
-               your PCs may freeze when sending messages (they should recover 
-               after 30 seconds, hopefully).</para>
-
-               <para>All messages are delivered as the global guest user. 
-               The command takes the standard substitutions, although <parameter moreinfo="none">
-               %u</parameter> won't work (<parameter moreinfo="none">%U</parameter> may be better 
-               in this case).</para>
-
-               <para>Apart from the standard substitutions, some additional 
-               ones apply. In particular:</para>
-
-               <itemizedlist>
-                       <listitem><para><parameter moreinfo="none">%s</parameter> = the filename containing 
-                       the message.</para></listitem>
+<samba:parameter name="message command"
+                context="G"
+                advanced="1" developer="1"
+                xmlns:samba="http://samba.org/common">
+<listitem>
+       <para>This specifies what command to run when the 
+       server receives a WinPopup style message.</para>
+
+       <para>This would normally be a command that would 
+       deliver the message somehow. How this is to be done is 
+       up to your imagination.</para>
+
+       <para>An example is:</para>
+
+       <para><command moreinfo="none">message command = csh -c 'xedit %s;rm %s' &amp;</command>
+       </para>
+
+       <para>This delivers the message using <command moreinfo="none">xedit</command>, then 
+       removes it afterwards. <emphasis>NOTE THAT IT IS VERY IMPORTANT 
+       THAT THIS COMMAND RETURN IMMEDIATELY</emphasis>. That's why I 
+       have the '&amp;' on the end. If it doesn't return immediately then 
+       your PCs may freeze when sending messages (they should recover 
+       after 30 seconds, hopefully).</para>
+
+       <para>All messages are delivered as the global guest user. 
+       The command takes the standard substitutions, although <parameter moreinfo="none">
+       %u</parameter> won't work (<parameter moreinfo="none">%U</parameter> may be better 
+       in this case).</para>
+
+       <para>Apart from the standard substitutions, some additional 
+       ones apply. In particular:</para>
+
+       <itemizedlist>
+               <listitem>
+                       <para><parameter moreinfo="none">%s</parameter> = the filename containing 
+                               the message.</para>
+               </listitem>
                        
-                       <listitem><para><parameter moreinfo="none">%t</parameter> = the destination that 
-                       the message was sent to (probably the server name).</para></listitem>
+               <listitem>
+                       <para><parameter moreinfo="none">%t</parameter> = the destination that 
+                               the message was sent to (probably the server name).</para>
+               </listitem>
 
-                       <listitem><para><parameter moreinfo="none">%f</parameter> = who the message 
-                       is from.</para></listitem>
-               </itemizedlist>
+               <listitem>
+                       <para><parameter moreinfo="none">%f</parameter> = who the message 
+                               is from.</para>
+               </listitem>
+       </itemizedlist>
 
-               <para>You could make this command send mail, or whatever else 
-               takes your fancy. Please let us know of any really interesting 
-               ideas you have.</para>
+       <para>You could make this command send mail, or whatever else 
+       takes your fancy. Please let us know of any really interesting 
+       ideas you have.</para>
 
+       <para>Here's a way of sending the messages as mail to root:</para>
 
-               <para>Here's a way of sending the messages as mail to root:</para>
+       <para><command moreinfo="none">message command = /bin/mail -s 'message from %f on 
+       %m' root &lt; %s; rm %s</command></para>
 
-               <para><command moreinfo="none">message command = /bin/mail -s 'message from %f on 
-               %m' root &lt; %s; rm %s</command></para>
+       <para>If you don't have a message command then the message 
+       won't be delivered and Samba will tell the sender there was 
+       an error. Unfortunately WfWg totally ignores the error code 
+       and carries on regardless, saying that the message was delivered.
+       </para>
 
-               <para>If you don't have a message command then the message 
-               won't be delivered and Samba will tell the sender there was 
-               an error. Unfortunately WfWg totally ignores the error code 
-               and carries on regardless, saying that the message was delivered.
-               </para>
+       <para>If you want to silently delete it then try:</para>
 
-               <para>If you want to silently delete it then try:</para>
+       <para><command moreinfo="none">message command = rm %s</command></para>
 
-               <para><command moreinfo="none">message command = rm %s</command></para>
+       <para>Default: <emphasis>no message command</emphasis></para>
 
-               <para>Default: <emphasis>no message command</emphasis></para>
-               <para>Example: <command moreinfo="none">message command = csh -c 'xedit %s;
-               rm %s' &amp;</command></para>
-               </listitem>
-               </samba:parameter>
+       <para>Example: <command moreinfo="none">message command = csh -c 'xedit %s; rm %s' &amp;</command></para>
+</listitem>
+</samba:parameter>
index 5a2980d4fd232a73b7df84c739164349150cf711..734dcf8de50cdda11652ac79b34617c4a618567c 100644 (file)
@@ -1,30 +1,33 @@
-<samba:parameter xmlns:samba="http://samba.org/common">
-               <term><anchor id="NISHOMEDIR"/>nis homedir (G)</term>
-               <listitem><para>Get the home share server from a NIS map. For 
-               UNIX systems that use an automounter, the user's home directory 
-               will often be mounted on a workstation on demand from a remote 
-               server. </para>
+<samba:parameter name="nis homedir"
+                context="G"
+                advanced="1" developer="1"
+                xmlns:samba="http://samba.org/common">
+<listitem>
+       <para>Get the home share server from a NIS map. For 
+       UNIX systems that use an automounter, the user's home directory 
+       will often be mounted on a workstation on demand from a remote 
+       server. </para>
 
-               <para>When the Samba logon server is not the actual home directory 
-               server, but is mounting the home directories via NFS then two 
-               network hops would be required to access the users home directory 
-               if the logon server told the client to use itself as the SMB server 
-               for home directories (one over SMB and one over NFS). This can 
-               be very slow.</para>
+       <para>When the Samba logon server is not the actual home directory 
+       server, but is mounting the home directories via NFS then two 
+       network hops would be required to access the users home directory 
+       if the logon server told the client to use itself as the SMB server 
+       for home directories (one over SMB and one over NFS). This can 
+       be very slow.</para>
 
-               <para>This option allows Samba to return the home share as 
-               being on a different server to the logon server and as 
-               long as a Samba daemon is running on the home directory server, 
-               it will be mounted on the Samba client directly from the directory 
-               server. When Samba is returning the home share to the client, it 
-               will consult the NIS map specified in <link linkend="HOMEDIRMAP">
-               <parameter moreinfo="none">homedir map</parameter></link> and return the server 
-               listed there.</para>
+       <para>This option allows Samba to return the home share as 
+       being on a different server to the logon server and as 
+       long as a Samba daemon is running on the home directory server, 
+       it will be mounted on the Samba client directly from the directory 
+       server. When Samba is returning the home share to the client, it 
+       will consult the NIS map specified in <link linkend="HOMEDIRMAP">
+       <parameter moreinfo="none">homedir map</parameter></link> and return the server 
+       listed there.</para>
 
-               <para>Note that for this option to work there must be a working 
-               NIS system and the Samba server with this option must also 
-               be a logon server.</para>
+       <para>Note that for this option to work there must be a working 
+       NIS system and the Samba server with this option must also 
+       be a logon server.</para>
 
-               <para>Default: <command moreinfo="none">nis homedir = no</command></para>
-               </listitem>
-               </samba:parameter>
+       <para>Default: <command moreinfo="none">nis homedir = no</command></para>
+</listitem>
+</samba:parameter>
index fc047e008de002fd88ccae2b41298a57b9c4c5d4..18c3345c6ca8af749279f295c5d31dd0a3b9487b 100644 (file)
@@ -1,23 +1,25 @@
-<samba:parameter xmlns:samba="http://samba.org/common">
-               <term><anchor id="PREEXEC"/>preexec (S)</term>
-               <listitem><para>This option specifies a command to be run whenever 
-               the service is connected to. It takes the usual substitutions.</para>
+<samba:parameter name="prexec"
+                context="S"
+                advanced="1" developer="1"
+                xmlns:samba="http://samba.org/common">
+<listitem>
+       <para>This option specifies a command to be run whenever 
+       the service is connected to. It takes the usual substitutions.</para>
 
-               <para>An interesting example is to send the users a welcome 
-               message every time they log in. Maybe a message of the day? Here 
-               is an example:</para>
+       <para>An interesting example is to send the users a welcome 
+       message every time they log in. Maybe a message of the day? Here 
+       is an example:</para>
 
-               <para><command moreinfo="none">preexec = csh -c 'echo \&quot;Welcome to %S!\&quot; |
-                /usr/local/samba/bin/smbclient -M %m -I %I' &amp; </command></para>
+       <para><command moreinfo="none">preexec = csh -c 'echo \&quot;Welcome to %S!\&quot; | /usr/local/samba/bin/smbclient -M %m -I %I' &amp; </command></para>
 
-               <para>Of course, this could get annoying after a while :-)</para>
+       <para>Of course, this could get annoying after a while :-)</para>
 
-               <para>See also <link linkend="PREEXECCLOSE"><parameter moreinfo="none">preexec close
-               </parameter></link> and <link linkend="POSTEXEC"><parameter moreinfo="none">postexec
-               </parameter></link>.</para>
+       <para>See also <link linkend="PREEXECCLOSE"><parameter moreinfo="none">preexec close</parameter></link> and <link 
+       linkend="POSTEXEC"><parameter moreinfo="none">postexec
+       </parameter></link>.</para>
 
-               <para>Default: <emphasis>none (no command executed)</emphasis></para>
-               <para>Example: <command moreinfo="none">preexec = echo \&quot;%u connected to %S from %m
-               (%I)\&quot; &gt;&gt; /tmp/log</command></para>
-               </listitem>
-               </samba:parameter>
+       <para>Default: <emphasis>none (no command executed)</emphasis></para>
+
+       <para>Example: <command moreinfo="none">preexec = echo \&quot;%u connected to %S from %m (%I)\&quot; &gt;&gt; /tmp/log</command></para>
+</listitem>
+</samba:parameter>
index e6de4bdcaf14ea1a87ee82bc191b08b6551ff6de..019cc306a7bb611903cacbf3acf32128d05578cf 100644 (file)
@@ -1,32 +1,35 @@
-<samba:parameter xmlns:samba="http://samba.org/common">
-               <term><anchor id="REMOTEANNOUNCE"/>remote announce (G)</term>
-               <listitem><para>This option allows you to setup <ulink url="nmbd.8.html">nmbd(8)</ulink> to periodically announce itself 
-               to arbitrary IP addresses with an arbitrary workgroup name.</para>
+<samba:parameter name="remote announce"
+                context="G"
+                advanced="1" developer="1"
+                xmlns:samba="http://samba.org/common">
+<listitem>
+       <para>This option allows you to setup <citerefentry><refentrytitle>nmbd</refentrytitle>
+       <manvolnum>8</manvolnum></citerefentry>to periodically announce itself 
+       to arbitrary IP addresses with an arbitrary workgroup name.</para>
 
-               <para>This is useful if you want your Samba server to appear 
-               in a remote workgroup for which the normal browse propagation 
-               rules don't work. The remote workgroup can be anywhere that you 
-               can send IP packets to.</para>
+       <para>This is useful if you want your Samba server to appear 
+       in a remote workgroup for which the normal browse propagation 
+       rules don't work. The remote workgroup can be anywhere that you 
+       can send IP packets to.</para>
 
-               <para>For example:</para>
+       <para>For example:</para>
 
-               <para><command moreinfo="none">remote announce = 192.168.2.255/SERVERS 
-               192.168.4.255/STAFF</command></para>
+       <para><command moreinfo="none">remote announce = 192.168.2.255/SERVERS 
+       192.168.4.255/STAFF</command></para>
 
-               <para>the above line would cause <command moreinfo="none">nmbd</command> to announce itself 
-               to the two given IP addresses using the given workgroup names. 
-               If you leave out the workgroup name then the one given in 
-               the <link linkend="WORKGROUP"><parameter moreinfo="none">workgroup</parameter></link> 
-               parameter is used instead.</para>
+       <para>the above line would cause <command moreinfo="none">nmbd</command> to announce itself 
+       to the two given IP addresses using the given workgroup names. 
+       If you leave out the workgroup name then the one given in 
+       the <link linkend="WORKGROUP"><parameter moreinfo="none">workgroup</parameter></link> 
+       parameter is used instead.</para>
 
-               <para>The IP addresses you choose would normally be the broadcast 
-               addresses of the remote networks, but can also be the IP addresses 
-               of known browse masters if your network config is that stable.</para>
+       <para>The IP addresses you choose would normally be the broadcast 
+       addresses of the remote networks, but can also be the IP addresses 
+       of known browse masters if your network config is that stable.</para>
 
-               <para>See the documentation file <ulink url="improved-browsing.html">BROWSING</ulink> 
-               in the <filename moreinfo="none">docs/</filename> directory.</para>
+       <para>See the documentation file <ulink url="improved-browsing.html">BROWSING</ulink> 
+       in the <filename moreinfo="none">docs/</filename> directory.</para>
                
-               <para>Default: <command moreinfo="none">remote announce = &lt;empty string&gt;
-               </command></para>
-               </listitem>
-               </samba:parameter>
+       <para>Default: <command moreinfo="none">remote announce = &lt;empty string&gt;</command></para>
+</listitem>
+</samba:parameter>
index 8b0d863ed7c57ec92192bcc6d1166fcbb56c663b..06069581e65067af50fa9b3abc4decb4bce65f64 100644 (file)
@@ -1,33 +1,35 @@
-<samba:parameter xmlns:samba="http://samba.org/common">
-               <term><anchor id="REMOTEBROWSESYNC"/>remote browse sync (G)</term>
-               <listitem><para>This option allows you to setup <ulink url="nmbd.8.html">nmbd(8)</ulink> to periodically request 
-               synchronization of browse lists with the master browser of a Samba 
-               server that is on a remote segment. This option will allow you to 
-               gain browse lists for multiple workgroups across routed networks. This 
-               is done in a manner that does not work with any non-Samba servers.</para>
+<samba:parameter name="remote browse sync"
+                context="G"
+                advanced="1" developer="1"
+                xmlns:samba="http://samba.org/common">
+<listitem>
+       <para>This option allows you to setup <citerefentry><refentrytitle>nmbd</refentrytitle>
+        <manvolnum>8</manvolnum></citerefentry> to periodically request 
+       synchronization of browse lists with the master browser of a Samba 
+       server that is on a remote segment. This option will allow you to 
+       gain browse lists for multiple workgroups across routed networks. This 
+       is done in a manner that does not work with any non-Samba servers.</para>
 
-               <para>This is useful if you want your Samba server and all local 
-               clients to appear in a remote workgroup for which the normal browse 
-               propagation rules don't work. The remote workgroup can be anywhere 
-               that you can send IP packets to.</para>
+       <para>This is useful if you want your Samba server and all local 
+       clients to appear in a remote workgroup for which the normal browse 
+       propagation rules don't work. The remote workgroup can be anywhere 
+       that you can send IP packets to.</para>
 
-               <para>For example:</para>
+       <para>For example:</para>
                
-               <para><command moreinfo="none">remote browse sync = 192.168.2.255 192.168.4.255
-               </command></para>
+       <para><command moreinfo="none">remote browse sync = 192.168.2.255 192.168.4.255</command></para>
 
-               <para>the above line would cause <command moreinfo="none">nmbd</command> to request 
-               the master browser on the specified subnets or addresses to 
-               synchronize their browse lists with the local server.</para>
+       <para>the above line would cause <command moreinfo="none">nmbd</command> to request 
+       the master browser on the specified subnets or addresses to 
+       synchronize their browse lists with the local server.</para>
 
-               <para>The IP addresses you choose would normally be the broadcast 
-               addresses of the remote networks, but can also be the IP addresses 
-               of known browse masters if your network config is that stable. If 
-               a machine IP address is given Samba makes NO attempt to validate 
-               that the remote machine is available, is listening, nor that it 
-               is in fact the browse master on its segment.</para>
+       <para>The IP addresses you choose would normally be the broadcast 
+       addresses of the remote networks, but can also be the IP addresses 
+       of known browse masters if your network config is that stable. If 
+       a machine IP address is given Samba makes NO attempt to validate 
+       that the remote machine is available, is listening, nor that it 
+       is in fact the browse master on its segment.</para>
 
-               <para>Default: <command moreinfo="none">remote browse sync = &lt;empty string&gt;
-               </command></para>
-               </listitem>
-               </samba:parameter>
+       <para>Default: <command moreinfo="none">remote browse sync = &lt;empty string&gt;</command></para>
+</listitem>
+</samba:parameter>
index e77737f18b56583f8443c94ad8f1be392f90ce9e..4d2299acda3d8a9f7f55bbbbab6e4279bc19d37d 100644 (file)
@@ -1,14 +1,16 @@
-<samba:parameter xmlns:samba="http://samba.org/common">
-               <term><anchor id="SOCKETADDRESS"/>socket address (G)</term>
-               <listitem><para>This option allows you to control what 
-               address Samba will listen for connections on. This is used to 
-               support multiple virtual interfaces on the one server, each 
-               with a different configuration.</para>
+<samba:parameter name="socket address"
+                context="G"
+                developer="1"
+                xmlns:samba="http://samba.org/common">
+<listitem>
+       <para>This option allows you to control what 
+       address Samba will listen for connections on. This is used to 
+       support multiple virtual interfaces on the one server, each 
+       with a different configuration.</para>
                
-               <para>By default Samba will accept connections on any 
-               address.</para>
+       <para>By default Samba will accept connections on any 
+       address.</para>
 
-               <para>Example: <command moreinfo="none">socket address = 192.168.2.20</command>
-               </para>
-               </listitem>
-               </samba:parameter>
+       <para>Example: <command moreinfo="none">socket address = 192.168.2.20</command></para>
+</listitem>
+</samba:parameter>
index 0c973234c39f97c49c06f107569f5fa3ad0eaac1..4cd12b6d3619566be25799bf87166bc688a086ba 100644 (file)
@@ -1,11 +1,15 @@
-<samba:parameter xmlns:samba="http://samba.org/common">
-               <term><anchor id="TIMEOFFSET"/>time offset (G)</term>
-               <listitem><para>This parameter is a setting in minutes to add 
-               to the normal GMT to local time conversion. This is useful if 
-               you are serving a lot of PCs that have incorrect daylight 
-               saving time handling.</para>
+<samba:parameter name="time offset"
+                context="G"
+                advanced="1" developer="1"
+                xmlns:samba="http://samba.org/common">
+<listitem>
+       <para>This parameter is a setting in minutes to add 
+       to the normal GMT to local time conversion. This is useful if 
+       you are serving a lot of PCs that have incorrect daylight 
+       saving time handling.</para>
                
-               <para>Default: <command moreinfo="none">time offset = 0</command></para>
-               <para>Example: <command moreinfo="none">time offset = 60</command></para>
-               </listitem>
-               </samba:parameter>
+       <para>Default: <command moreinfo="none">time offset = 0</command></para>
+
+       <para>Example: <command moreinfo="none">time offset = 60</command></para>
+</listitem>
+</samba:parameter>