Doc updates from John + some minor fixes by me
[samba.git] / docs / docbook / smbdotconf / misc / dontdescend.xml
1 <samba:parameter xmlns:samba="http://samba.org/common">
2                 <term><anchor id="DONTDESCEND"/>dont descend (S)</term>
3                 <listitem><para>There are certain directories on some systems 
4                 (e.g., the <filename moreinfo="none">/proc</filename> tree under Linux) that are either not 
5                 of interest to clients or are infinitely deep (recursive). This 
6                 parameter allows you to specify a comma-delimited list of directories 
7                 that the server should always show as empty.</para>
8
9                 <para>Note that Samba can be very fussy about the exact format 
10                 of the &quot;dont descend&quot; entries. For example you may need <filename moreinfo="none">
11                 ./proc</filename> instead of just <filename moreinfo="none">/proc</filename>. 
12                 Experimentation is the best policy :-)  </para>
13                 
14                 <para>Default: <emphasis>none (i.e., all directories are OK 
15                 to descend)</emphasis></para>
16                 <para>Example: <command moreinfo="none">dont descend = /proc,/dev</command></para>
17                 </listitem>
18                 </samba:parameter>