[Samba] smb.conf(5) format meaning question

[Michael Wood]

2009/9/17 Linda Walsh <samba at tlinx.org>:
> Michael Wood wrote:
>> S means it can be used in a share definition and also in the Global section:
>>
>>> I've sorta got it in my head that most (S) switch that could make sense globally,
>>> could be used/set in the global section as a 'default' for all shares, but
>>> I don't find that documented in the manpage, so I'm questioning...??
>>
>> It's in the PARAMETERS section.
> ----
>        Thanks for pointing to the right paragraph.  I think I glossed over
> it because I didn't see the same notation in the definition, as used in
> the successive text.
>
>        There are some notational conventions used in the documentation
> that I feel could use some improvement, but I know, in some cases, that
> the underlying source is based on DocBook, and I don't know if some of
> those conventions are enforced by DB, or can be adjusted with a style
> sheet.  But until I think or come up with a better concrete solution,
> I'll keep my mouth shut and just thank you for pointing me at the
> correct section...:-)

Well, I searched for it first as \(S and didn't find it, so I searched
for \<S\> instead and I didn't have to go through very many false
positives before finding that paragraph :)

I agree it would probably be harder to miss if the references in that
paragraph also used parentheses.

-- 
Michael Wood <esiotrot at gmail.com>