summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMichael Adam <obnox@samba.org>2007-06-26 08:11:40 +0000
committerGerald W. Carter <jerry@samba.org>2008-04-23 08:47:34 -0500
commit028979a3ba9e74dbd347c270ce9d39978cab088c (patch)
treeffe631e9f01a7b7ac48f04cf76bd4d8f26057ba3
parent31e61423b9f7b708dcb79b7932b9c3d582988d5f (diff)
downloadsamba-028979a3ba9e74dbd347c270ce9d39978cab088c.tar.gz
samba-028979a3ba9e74dbd347c270ce9d39978cab088c.tar.bz2
samba-028979a3ba9e74dbd347c270ce9d39978cab088c.zip
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 (This used to be commit 727017fe04dfa35774fd02ffe0ea0b819146bfac)
-rw-r--r--docs/manpages-3/smb.conf.5.xml33
-rw-r--r--docs/smbdotconf/misc/include.xml5
-rw-r--r--docs/smbdotconf/misc/registryshares.xml2
3 files changed, 23 insertions, 17 deletions
diff --git a/docs/manpages-3/smb.conf.5.xml b/docs/manpages-3/smb.conf.5.xml
index ff527c1f53..1592195f98 100644
--- a/docs/manpages-3/smb.conf.5.xml
+++ b/docs/manpages-3/smb.conf.5.xml
@@ -724,17 +724,18 @@ chmod 1770 /usr/local/samba/lib/usershares
<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 @@ chmod 1770 /usr/local/samba/lib/usershares
<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 @@ chmod 1770 /usr/local/samba/lib/usershares
</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 @@ chmod 1770 /usr/local/samba/lib/usershares
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>
diff --git a/docs/smbdotconf/misc/include.xml b/docs/smbdotconf/misc/include.xml
index 84e20dff89..d8179ef1b0 100644
--- a/docs/smbdotconf/misc/include.xml
+++ b/docs/smbdotconf/misc/include.xml
@@ -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
diff --git a/docs/smbdotconf/misc/registryshares.xml b/docs/smbdotconf/misc/registryshares.xml
index 5557661998..0295c5c85c 100644
--- a/docs/smbdotconf/misc/registryshares.xml
+++ b/docs/smbdotconf/misc/registryshares.xml
@@ -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.