Author: obnox Date: 2007-06-26 08:11:40 +0000 (Tue, 26 Jun 2007) New Revision: 1128
WebSVN: http://websvn.samba.org/cgi-bin/viewcvs.cgi?view=rev&root=samba-docs&rev=1128 Log: Fix a couple of tags. It is a little cumbersome for me to debug my manpage-sourcecode since I can only see useful output once It is on http://samba.org/~samba-bugs/docs/ ... :-/ (I have not yet come across a system that can produce readable manpage output from the source.) Michael Modified: trunk/manpages-3/smb.conf.5.xml trunk/smbdotconf/misc/include.xml trunk/smbdotconf/misc/registryshares.xml Changeset: Modified: trunk/manpages-3/smb.conf.5.xml =================================================================== --- trunk/manpages-3/smb.conf.5.xml 2007-06-22 22:44:13 UTC (rev 1127) +++ trunk/manpages-3/smb.conf.5.xml 2007-06-26 08:11:40 UTC (rev 1128) @@ -724,17 +724,18 @@ <listitem><para>Share definitions stored in registry are used. This is triggered by setting the global parameter <parameter>registry shares</parameter> to - <term>yes</term> in <term>smb.conf</term>. + <quote>yes</quote> in <emphasis>smb.conf</emphasis>. </para> - <para>Note: Shares defined in <term>smb.conf</term> always take priority over + + <para>Note: Shares defined in <emphasis>smb.conf</emphasis> always take priority over shares of the same name defined in registry. </para></listitem> - <listitem><para>Global <term>smb.conf</term> options stored in + <listitem><para>Global <emphasis>smb.conf</emphasis> options stored in registry are used. This is triggered by a new special meaning of the - parameter <parameter>include = registry</parameter> in - the [global] section of <term>smb.conf</term>. + parameter <smbconfoption name="include">registry</smbconfoption> in + the [global] section of <emphasis>smb.conf</emphasis>. This reads the content of the global configuration section from the regsitry and includes the result with the same priorities as @@ -746,7 +747,7 @@ <para> Even when global registry options are used, the initial source of - configuration is still the <term>smb.conf</term> file. + configuration is still the <emphasis>smb.conf</emphasis> file. It is this possible though, to produce a registry-only configuration with a minimal configuration file like this: <programlisting> @@ -755,8 +756,10 @@ </programlisting> This is also currently the only supported configuration with global registry options activated. More precisely, it is only supported to - specify options in <term>smb.conf</term> <emph>before</emph> the - occurrence of <parameter>include = registry</parameter>. + specify options in <emphasis>smb.conf</emphasis> + <emphasis>before</emphasis> the + occurrence of + <smbconfoption name="include">registry</smbconfoption>. </para> <para> @@ -769,22 +772,24 @@ do not see the configuration they loaded once it is active. This phenomenon can of course also be triggered by specifying <parameter>lock directory</parameter> after the - <parameter>include = registry</parameter> directive. This is why + <smbconfoption name="include">registry</smbconfoption> directive. + This is why this type of configuration is classified "unsupported" above. </para> <para> The registry configuration can be accessed with - tools like <term>regedit</term> or <term>net rpc - registry</term> in the key - <term>HKLM\Software\Samba\smbconf</term>. + tools like <emphasis>regedit</emphasis> or <emphasis>net rpc + registry</emphasis> in the key + <emphasis><literal>HKLM\Software\Samba\smbconf</literal></emphasis>. - More conveniently, the <term>conf</term> subcommand of the + More conveniently, the <emphasis>conf</emphasis> subcommand of the <citerefentry><refentrytitle>net</refentrytitle> <manvolnum>7</manvolnum></citerefentry> utility offers a dedicated interface to read and write the registry based configuration locally, i.e. directly - on the server. + accessing the database file, circumventing the + server. </para> </refsect1> Modified: trunk/smbdotconf/misc/include.xml =================================================================== --- trunk/smbdotconf/misc/include.xml 2007-06-22 22:44:13 UTC (rev 1127) +++ trunk/smbdotconf/misc/include.xml 2007-06-26 08:11:40 UTC (rev 1128) @@ -15,9 +15,10 @@ </para> <para> - The parameter <parameter>include = registry</parameter> has + Since Samba version 3.0.26, setting + <smbconfoption name="include">registry</smbconfoption> has a special meaning: It does <emphasis>not</emphasis> include - a file named <term>registry</term> from the current working + a file named <emphasis>registry</emphasis> from the current working directory, but instead reads the global configuration options from the registry. See the section on registry-based configuration for details. Note that this option Modified: trunk/smbdotconf/misc/registryshares.xml =================================================================== --- trunk/smbdotconf/misc/registryshares.xml 2007-06-22 22:44:13 UTC (rev 1127) +++ trunk/smbdotconf/misc/registryshares.xml 2007-06-26 08:11:40 UTC (rev 1128) @@ -6,7 +6,7 @@ <description> <para> This turns on or off support for share definitions read from - registry. Shares in defined in <term>smb.conf</term> take + registry. Shares in defined in <emphasis>smb.conf</emphasis> take precedence over shares with the same name defined in registry. See the section on registry-based configuration for details.